ModsJava
WorldScript
Open-world RPG region events, particles, and scripting for Paper servers.
⬇ Download on Hangar
Advanced Minecraft RPG Region Plugin
Region Events · Unlockable Progression · Rewards · Kether Scripts · GUI & YAML Configuration
Features

Quick Start
## Requirements
- Java: 8 for Minecraft 1.12.2–1.16.x
- Java: 17 for Minecraft 1.17–1.20.4
- Java: 21 for Minecraft 1.20.5–1.21.8
- Server: Paper 1.12.2–1.21.8
- PlaceholderAPI: Optional, required only for placeholders
- TabooLib and Kether are bundled with WorldScript
## Installation
I. Download from [SpigotMC](https://www.spigotmc.org/resources/worldscript-1-12-2-1-21-8-%EF%B8%8Frpg-region-framework-%E2%9A%A1dynamic-events-player-progression%E2%9A%A1.138114/), [Modrinth](https://modrinth.com/plugin/worldscript) the JAR file in the server's:
```
plugins/
```
Restart the server once.
II. Create Your First Region
```
/ws wand
```
III. Select two corners with the wand, then run:
```
/ws create forest_entrance
```
IV. The region is automatically saved to:
```
plugins/WorldScript/regions/forest_entrance.yml
```
You can edit it using:
```
/ws gui
/ws edit forest_entrance
```
Powerful Configuration

Region Inheritance
WorldScript supports parent and child regions, allowing shared settings and progression logic to be inherited across your world.
```
schema: 2
id: whispering_forest
identity:
name: Whispering Forest
role: open_zone
parent: starter_valley
location:
world: world
priority: 0
min: {x: 10, y: 50, z: 10}
max: {x: 70, y: 100, z: 70}
state:
inherit: true
statuses: []
variables:
short_name: Forest
events:
enter:
enabled: true
inherit: false
mode: first
actions:
- type: message
value: "&2The Whispering Forest is filled with ancient secrets."
- type: console_command
value: "your-quest-plugin start forest_intro %player%"
```
### The region inherits shared configuration from `starter_valley`, while `inherit: false` allows the child region to define its own enter event.
###

WorldScript is a free Minecraft Java mod. Compatible with Minecraft 1.12, 1.12.1, 1.12.2, 1.13 and newer. Available via Hangar. Download it and open it directly in the game.