🔥 FirePlugin

MIT License

Starting from version 2.0.0 + MIT, the source code license has been changed from CC BY-SA 4.0 to the MIT license.

Version 2.0.0 – A lightweight, high‑performance server utility plugin for Paper 1.21+.
It provides world‑based economy reset, block protection, building restrictions, advanced world rules, anti‑spam, a broadcast credit system, and a clickable invite system.

---

✨ Features

• Economy reset – Automatically clear players' Vault balances in specified worlds (supports regex/wildcard).
• Block protection – Only blocks placed by players can be broken, burned, or destroyed by explosions.
• Build restriction – Prevent block placement in chosen worlds.
• World rules – Per‑world options:
  • Disable PvP
  • Make players invincible
  • Unlimited saturation (no hunger loss)
  • Void respawn (teleport back to world spawn instead of dying)
• Anti‑spam – Limit chat messages per time interval.
• Broadcast system – Players spend credits to send server‑wide messages. Credits are stored per player and can be managed by admins.
• Invite system – Send clickable invites to individuals or everyone. Invited players click the message to teleport directly to the inviter's world.
• All world rules support regex/wildcard patterns (e.g. lobby*, pvp-*, *).
• Bypass permissions – Each restriction has its own permission node.
• Efficient listener‑based design – No performance‑heavy persistent storage for placed blocks.

---

📥 Installation

1. Download the latest fire-2.0.0.jar.
2. Place it in your server’s plugins/ folder.
3. Restart the server.
4. Configure plugins/fire/config.yml to your needs (see below).
5. Use /fireadmin reload to reload the configuration at any time.

---

🔧 Commands

| Command & Aliases | Permission | Description |
| ------------------------------------------------------------ | ---------------------- | ------------------------------------------------------------ |
| /broadcast <message> = /bc <message> | fire.broadcast.use | Send a broadcast (consumes 1 credit). |
| /broadcastadmin add <player> <amount> = /bcadmin add ... | fire.broadcast.admin | Add broadcast credits to a player. |
| /broadcastadmin set <player> <amount> | fire.broadcast.admin | Set a player's credits to a specific amount. |
| /broadcastadmin clear <player> | fire.broadcast.admin | Reset a player's credits to 0. |
| /broadcastadmin check <player> | fire.broadcast.admin | Show a player's remaining credits. |
| /invite <player\|all> [world] = /inv ... | fire.invite.send | Send an invite to a player or everyone. Optional world name. |
| /invite accept <inviter> | fire.invite.join | Accept an invite and teleport to the inviter's world. |
| /fireadmin reload = /fadmin reload | fire.admin | Reload the plugin configuration. |

---

🔐 Permissions

| Node | Default | Description |
| ---------------------- | ------- | ------------------------------------------------------ |
| fire.bypass.clear | op | Prevents economy reset in reset worlds. |
| fire.bypass.block | op | Allows breaking any block (bypasses block protection). |
| fire.bypass.build | op | Allows placing blocks in no-build-worlds. |
| fire.broadcast.use | true | Allows using /broadcast. |
| fire.broadcast.admin | op | Allows managing broadcast credits. |
| fire.invite.send | true | Allows sending invites. |
| fire.invite.join | true | Allows accepting invites. |
| fire.admin | op | Allows reloading the plugin. |

---

⚙️ Configuration (config.yml)

# Worlds where player balances are cleared (regex/wildcard)
economy-reset-worlds:
  - "Lobby"
  - "lobby_*"
economy-reset-interval-ticks: 1200 # 20 ticks = 1 sec

# Worlds where only player‑placed blocks can be broken/burned/exploded
block-protection-worlds:
  - "*"

# Worlds where block placement is forbidden (requires fire.bypass.build)
no-build-worlds:
  - "Lobby"
  - "hub*"

# Worlds where PvP is disabled
pvp-disabled-worlds:
  - "Lobby"

# Worlds where players take no damage (invincible)
invincible-worlds:
  - "Lobby"

# Worlds where hunger never decreases
saturate-worlds:
  - "Lobby"

# Worlds where falling into the void teleports you to world spawn
void-respawn-worlds:
  - "*"

# Anti‑spam settings
anti-spam:
  interval-seconds: 3
  max-messages: 2

# Broadcast system
broadcast:
  default-credits: 3 # Starting credits per player

# Invite cooldown (seconds)
invite:
  cooldown-seconds: 10

Note: Patterns support * wildcard and regular expressions. Example: "lobby*" matches lobby, lobby_1, lobby_world, etc.

---

🛠 Building from source

1. Clone or download the source code.
2. Ensure you have Java 21 and Maven installed.
3. Run mvn clean package.
4. The compiled JAR will be in target/fire-2.0.0.jar.

---

📄 License

This project is licensed under the MIT license.

---

💬 Support

For issues or suggestions, please contact the plugin author: cyx012113 (Discord / GitHub).
Pull requests and contributions are welcome under the same license.