Region Signs

RegionSigns is a Paper plugin that allows you to turn regular signs into beautiful region displays for players who enter their radius. Perfect for private servers, survival servers, SMP, or MMORPG/RPG projects I originally made this for myself and my KTO ETO SMP, and didn’t plan to release it… but why not?

If you notice a bug, or want to suggest some new functionality, write to my server in Discord, in the `#region-signs`, or in private messages to the Telegram channel

When a player enters a sign’s radius, a Title/BossBar is displayed using the sign’s text, with customizable sounds and particles.

Features:

* 4 region tiers (fully configurable and extendable) > * Iron - 25 blocks radius > * Gold — 50 blocks radius > * Diamond - 100 blocks radius > * Netherite - 400 blocks radius * Per-player settings * PlaceholderAPI * MiniMessage

How to create Region Sign?

1. Place a sign 2. Write the region name 3. Drop one of the following items onto the sign: > * Iron - 25 blocks radius > * Gold - 50 blocks radius > * Diamond - 100 blocks radius > * Netherite - 400 blocks radius If a region already exists, it will be upgraded to a higher tier. To remove a region, simply break the sign.

Commands:

`/regionsigns <all|titles|bossbar|sounds|particles> [on|off|toggle]`

`/regionsigns reload` - reloads the config

`/regionsigns` - shows current settings

Permissions:

`regionsigns.command` - access to commands

`regionsigns.admin` - allows /regionsigns reload

`regionsigns.create` - create and upgrade regions

`regionsigns.remove` - remove regions

`regionsigns.view` - see region display

`regionsigns.view.titles`

`regionsigns.view.bossbar`

`regionsigns.view.sounds`

`regionsigns.view.particles`

PlaceholderAPI:

`%regionsigns_name%` - current region name

`%regionsigns_tier%` - region tier

`%regionsigns_world%` - world

`%regionsigns_radius%` - radius

`%regionsigns_material%` - sign (OAK_SIGN)

Configuration:

```yaml language: "en_us" # 1.0.1 upd / or ru_ru

features: enabled: true titles: true consume-items: true # 1.0.1 upd bossbar: true sounds: true actionbar: false # 1.0.1 upd particles: true

check-interval-ticks: 20

worlds: []

titles: header: "<name>" subheader: "" fade-in: 5 stay: 40 fade-out: 10

bossbar: text: "<name>" color: "YELLOW" overlay: "PROGRESS"

1.0.1 upd

actionbar: text: "<name>"

tiers: IRON: radius: 25 effects: enter: sounds: - "minecraft:block.ender_chest.open 5 0.7" create: sounds: - "minecraft:block.amethyst_block.break 2 1" - "minecraft:block.bell.resonate 2 2" particles: - "WAX_OFF 5 0 0 0 0.15" GOLD: radius: 50 effects: enter: sounds: - "minecraft:block.ender_chest.open 5 0.7" - "minecraft:entity.evoker.prepare_summon 5 0.95" - "minecraft:entity.evoker.prepare_summon 5 1.17" create: sounds: - "minecraft:block.amethyst_block.break 2 1" - "minecraft:block.bell.resonate 2 2" particles: - "WAX_OFF 15 0 0 0 0.15" DIAMOND: radius: 100 effects: enter: sounds: - "minecraft:block.ender_chest.open 5 0.7" - "minecraft:entity.evoker.prepare_summon 5 0.8" - "minecraft:entity.evoker.prepare_summon 5 0.95" - "minecraft:entity.evoker.prepare_summon 5 1.17" create: sounds: - "minecraft:block.amethyst_block.break 2 1" - "minecraft:block.bell.resonate 2 2" particles: - "WAX_OFF 25 0 0 0 0.15" - "FLAME 20 0 0.25 0 0.03" NETHERITE: radius: 300 effects: enter: sounds: - "minecraft:block.ender_chest.open 5 0.7" - "minecraft:entity.evoker.prepare_summon 5 0.8" - "minecraft:entity.evoker.prepare_summon 5 0.95" - "minecraft:entity.evoker.prepare_summon 5 1.17" - "minecraft:block.bell.resonate 5 1.15" create: sounds: - "minecraft:block.amethyst_block.break 2 1" - "minecraft:block.bell.resonate 2 2" particles: - "WAX_OFF 50 0 0 0 0.15" - "SOUL 20 0 0.25 0 0.03"

defaults: empty-sign-name: "Region"

```

Roadmap:

* backport to older versions? like >1.20, >1.16 <1.8 * gradients/books? * Dynmap / BlueMap? * commands for create nosign regions? * optimization? * more permissions? * customization?

If you notice a bug, or want to suggest some new functionality, write to my server in Discord, in the `#region-signs`, or in private messages to the Telegram channel

original idea and implementation: https://www.planetminecraft.com/data-pack/journey-area-title-generator/