# 🔥 FirePlugin [MIT License](https://mit-license.org/) 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`) ```yaml # 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.

# Obsidian Change Powder Plugin [](https://creativecommons.org/licenses/by-sa/4.0/legalcode.txt) **Version 2.0.0** – A lightweight Paper/Spigot plugin that lets players convert obsidian into wooden planks using a special powder. ## Features - Right-click obsidian with **Obsidian Change Powder** to start conversion. - Configurable conversion delay (default 3 seconds) and cooldown (default 5 seconds). - Fully customizable messages and result block material. - Tab completion for the `/obsidian give` command. - Permission system (`obsidian.use` to use the item, `obsidian.admin` to give items). ## Installation 1. Download the latest `obsidian_change-2.0.0.jar`. 2. Place it in your server's `plugins/` folder. 3. Restart the server (or reload plugins). 4. The configuration file `plugins/obsidian_change/config.yml` will be generated automatically. 5. Edit the config to your liking and reload with `/obsidian reload` (optional, requires plugin restart for current version). ## Commands & Permissions | Command | Permission | Description | | --------------------------------------------------------- | ---------------- | -------------------------------------------------------------------------- | | `/obsidian give [player] obsidian_change_powder [amount]` | `obsidian.admin` | Give the powder to a player. If no player is specified, gives to yourself. | | N/A | `obsidian.use` | Allows players to right-click with the powder. (Default: true) | ## Configuration (`config.yml`) ```yaml # Delay before conversion (ticks, 20 ticks = 1 sec) conversion-time-ticks: 60 # Cooldown after using (seconds) cooldown-seconds: 5 # Result block material (any valid Bukkit Material) result-block: OAK_PLANKS # All message strings – use & for color codes, {placeholder} for dynamic values messages: must-look-obsidian: "&cYou must look at obsidian to use!" cooldown: "&cSkill on cooldown, remaining {seconds} seconds" already-converting: "&cYou already have an ongoing conversion!" start-conversion: "&eStarting obsidian conversion, please wait {seconds} seconds..." success: "&aObsidian successfully converted to {result}!" failed: "&cConversion failed: target block has been changed or destroyed." usage-give: "&cUsage: /obsidian give [player] obsidian_change_powder [amount]" unknown-item: "&cUnknown item: {item}" player-not-online: "&cPlayer {player} is not online!" given: "&aGiven {player} {amount} Obsidian Change Powder" received: "&aYou have received {amount} Obsidian Change Powder" console-must-specify: "&cConsole must specify player name: /obsidian give <player> obsidian_change_powder [amount]" amount-integer: "&cAmount must be an integer!" ``` ## How to use in-game 1. Obtain the powder: `/obsidian give obsidian_change_powder 1` (requires `obsidian.admin`). 2. Hold it in your hand. 3. Right-click on any obsidian block. 4. Wait the configured delay (default 3 seconds) – the block will turn into wooden planks. 5. After a successful conversion, you must wait the cooldown period before using another powder. ## Developer Information - **API version**: 1.21 - **Dependencies**: None (pure Paper/Spigot API) - **Source code**: Fully open under [insert license] - **Author**: cyx012113 ## Building from source 1. Clone the repository. 2. Use Maven: `mvn clean package` 3. The output JAR will be in `target/obsidian_change-2.0.0.jar`. ## License This plugin is licensed under CC BY-SA 4.0. You are free to share and adapt it, but must give appropriate credit and share under the same license. ## Support For issues or suggestions, contact the author via Discord or GitHub.