Fire Plugin

🔥 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

🔐 Permissions

⚙️ 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.