Description

GatherRang Plugin for Rust

Plugin Preview

Overview:

• GatherRang is an awesome plugin for Rust that takes resource gathering to the next level. It lets players collect wood and other essential resources using a range of weapons like bows, pistols, shotguns, SMGs, and rifles. With built-in permission support and easy-to-customize settings, GatherRang gives both players and server admins the flexibility to create a fun and personalized gathering experience. Whether you’re hunting for wood or mining for resources, this plugin makes it all more exciting!

Key Features:

Resource Gathering:

• Players can gather wood from trees and resources from nodes (stone, sulfur, metal) by hitting them with specified ranged weapons.
• Each weapon type has unique gathering rates, ensuring a balanced gameplay experience.

Bonus Resources:

• Players can earn bonus resources upon fully destroying trees or nodes, incentivizing exploration and resource management.
• Bonus resources vary depending on the weapon used and the player’s permissions.

Permission System:

• The plugin features a comprehensive permission system that allows server admins to control who can gather resources and under what conditions.
• Permissions can be assigned to individual players or groups, providing flexibility in gameplay.

Customizable Configuration:

• Server admins can easily configure gathering rates and bonus amounts for each weapon type through a user-friendly configuration file.
• The plugin loads default configurations upon installation but can be easily adjusted to fit the server’s needs.

Chat Notifications:

• Players receive real-time chat notifications when they gather resources, enhancing engagement and awareness of their actions.
• The notification system includes updates for total resources gathered, allowing players to track their progress.

Chat Icon ID:

• The GatherRang plugin provides the option to set a chat icon ID for notifications sent to players, enhancing the visual appeal of chat messages.
• Customization: Players can customize the chat icon that appears alongside their notifications by setting the STEAMID of the profile that has the desired picture. This allows for personalized notifications that reflect the player’s identity or community branding.
• How to Set: To configure the chat icon, players must input the STEAMID of their Steam profile that features the desired icon. This customization is easily managed through the plugin’s configuration file, ensuring a smooth setup process.

Permissions:

GatherRang utilizes a detailed permission system to manage access to various features. The following permissions are available:

• gatherrang.use: Required for players to use the gathering functionality.
• gatherrang.bowtree: Allows players to gather wood from trees using bows.
• gatherrang.bownode: Allows players to gather resources from nodes using bows.
• gatherrang.bowtreecoal: Grants players the ability to gather charcoal when using bows on trees.
• gatherrang.pistoltree: Allows players to gather wood from trees using pistols.
• gatherrang.pistoltreecoal: Grants players the ability to gather charcoal when using pistols on trees.
• gatherrang.pistolnode: Allows players to gather resources from nodes using pistols.
• gatherrang.shotguntree: Allows players to gather wood from trees using shotguns.
• gatherrang.shotguntreecoal: Grants players the ability to gather charcoal when using shotguns on trees.
• gatherrang.shotgunnodes: Allows players to gather resources from nodes using shotguns.
• gatherrang.smgtree: Allows players to gather wood from trees using SMGs.
• gatherrang.smgtreecoal: Grants players the ability to gather charcoal when using SMGs on trees.
• gatherrang.smgnodes: Allows players to gather resources from nodes using SMGs.
• gatherrang.rifletree: Allows players to gather wood from trees using rifles.
• gatherrang.rifletreecoal: Grants players the ability to gather charcoal when using rifles on trees.
• gatherrang.riflenodes: Allows players to gather resources from nodes using rifles.

Configuration:

The configuration file allows server admins to customize various aspects of the plugin. Key configuration options include:

Gathering Rates:

• Configurable rates for each weapon type (bows, pistols, shotguns, SMGs, rifles) for wood, stone, sulfur, and metal.
• Default values can be set upon installation or modified as needed.

Bonus Amounts:

• Players can receive bonus resources for fully destroying trees and nodes.
• Configurable values allow for tailored gameplay experiences.

Chat Icon ID:

• The option to set a chat icon ID for notifications sent to players, enhancing the visual appeal of chat messages. Players need to set the STEAMID of the profile that has the picture they want to be displayed.

Default Configuration Preview:

{
  "BowWoodGatheredPerHit": 10,
  "BowCharcoalGatheredPerHit": 2,
  "BowBonusWood": 20,
  "BowBonusCharcoal": 5,
  "BowStoneGatheredPerHit": 5,
  "BowBonusStone": 10,
  "BowMetalGatheredPerHit": 5,
  "BowBonusMetal": 10,
  "BowSulfurGatheredPerHit": 5,
  "BowBonusSulfur": 10,
  "BowHQMetalDestructionGather": 2,
  "BowBonusHQMetal": 5,

  "PistolWoodGatheredPerHit": 8,
  "PistolCharcoalGatheredPerHit": 1,
  "PistolBonusWood": 15,
  "PistolBonusCharcoal": 3,
  "PistolStoneGatheredPerHit": 4,
  "PistolBonusStone": 8,
  "PistolMetalGatheredPerHit": 4,
  "PistolBonusMetal": 8,
  "PistolSulfurGatheredPerHit": 4,
  "PistolBonusSulfur": 8,
  "PistolHQMetalDestructionGather": 1,
  "PistolBonusHQMetal": 3,

  "ShotgunWoodGatheredPerHit": 6,
  "ShotgunCharcoalGatheredPerHit": 1,
  "ShotgunBonusWood": 12,
  "ShotgunBonusCharcoal": 4,
  "ShotgunStoneGatheredPerHit": 6,
  "ShotgunBonusStone": 10,
  "ShotgunMetalGatheredPerHit": 6,
  "ShotgunBonusMetal": 12,
  "ShotgunSulfurGatheredPerHit": 6,
  "ShotgunBonusSulfur": 12,
  "ShotgunHQMetalDestructionGather": 2,
  "ShotgunBonusHQMetal": 5,

  "SMGWoodGatheredPerHit": 7,
  "SMGCharcoalGatheredPerHit": 2,
  "SMGBonusWood": 15,
  "SMGBonusCharcoal": 4,
  "SMGStoneGatheredPerHit": 4,
  "SMGBonusStone": 9,
  "SMGMetalGatheredPerHit": 4,
  "SMGBonusMetal": 9,
  "SMGSulfurGatheredPerHit": 4,
  "SMGBonusSulfur": 9,
  "SMGHQMetalDestructionGather": 2,
  "SMGBonusHQMetal": 4,

  "RifleWoodGatheredPerHit": 9,
  "RifleCharcoalGatheredPerHit": 2,
  "RifleBonusWood": 18,
  "RifleBonusCharcoal": 5,
  "RifleStoneGatheredPerHit": 5,
  "RifleBonusStone": 10,
  "RifleMetalGatheredPerHit": 5,
  "RifleBonusMetal": 10,
  "RifleSulfurGatheredPerHit": 5,
  "RifleBonusSulfur": 10,
  "RifleHQMetalDestructionGather": 2,
  "RifleBonusHQMetal": 5,

  "ChatIconID": "0" // Default to "0" if not set
}

GatherRang

• is a game-changing plugin that every Rust server needs to elevate the resource-gathering experience. With its innovative mechanics, players can effortlessly gather wood and essential resources using their favorite ranged weapons—it adds a thrilling layer of strategy to gameplay!
• Server admins will appreciate the easy-to-use permission system and customizable settings, allowing them to tailor the experience for their community. Don’t let your server fall behind; make it a vibrant, resource-rich environment that keeps players hooked. Grab GatherRang today and watch your server come alive!

​