ResourcesWorld

ResourcesWorld is a Folia 1.21.11 plugin by Allync that manages a dedicated resources world with automatic loading, border setup, safe teleporting, portal linking, and scheduled regeneration.

Features

• Automatically creates and loads resources_world and resources_world_nether
• Applies a 10000 x 10000 world border by default
• Supports configurable keepInventory
• Disables death messages and advancement announcements in both managed worlds
• Adds /resources with:
  • 5 second warmup
  • 10 minute cooldown
  • random safe teleport inside a 5000 block radius
• Evacuates players to a safe fallback location before regeneration
• Regenerates the resources worlds every 7 days at 00:00 WIB by default
• Sends completion chat, title, subtitle, and sound feedback after regeneration
• Links resources_world and resources_world_nether portals automatically
• Auto-loads managed worlds through the Worlds plugin, so no manual /world load is needed

Requirements

• Java 21
• Folia 1.21.11
• Worlds plugin

Worlds is strongly recommended here because Folia rejects the normal Bukkit world creation flow that many older plugins use.

Managed Worlds

• Overworld: resources_world
• Nether: resources_world_nether

Command

• /resources - teleports a player to a safe random spot in the resources world

Default Behavior

• Border center: 0, 0
• Border size: 10000
• /resources max radius: 5000
• Cooldown: 10 minutes
• Warmup: 5 seconds
• Regen interval: every 7 days
• Regen timezone: Asia/Jakarta
• Regen time: 00:00
• Safe fallback world: Spawn

Installation

1. Install Folia 1.21.11.
2. Install the Worlds plugin.
3. Put this plugin jar into your server plugins folder.
4. Start the server once to generate config.yml.
5. Adjust the config if needed, then restart the server.

Build

This project uses Gradle with local compile-only jars stored in libs.

gradlew.bat build

Compiled jar output:

build/libs/Resources-World-1.0.0.jar

Configuration

Main config file:

src/main/resources/config.yml

Important sections:

• worlds - names, border, keep inventory, Worlds integration flag
• resources-command - cooldown, warmup, search radius, search attempts
• portal-link - nether portal search and creation settings
• safe-fallback - safe evacuation destination
• regeneration - interval, timezone, time, retry delay
• messages - all chat/title defaults

If the plugin has already generated a config on your server, updating this repository will not overwrite the live server config automatically.

Notes

• The plugin is marked folia-supported: true
• Managed worlds are configured on load and after every regeneration
• If Worlds is available, portal linking is registered through its link system
• If you change managed world names, keep them unique and do not reuse your main world name

Author

Allync