Correct sound and material names must be used. Refer to the Spigot docs for more information:
Sounds: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
Materials: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
¶ Main configuration
To enable legacy support for WorldGuard integrations, you will need to set the integration to
WorldGuard_Legacy.
settings.integration.name: name of protection plugin to use (default: WorldGuard*)
settings.storage.mode: type of storage to use, either file or sql (default: file)
settings.sql.host: IP of the sql server (default: localhost)
settings.sql.port: Port of the sql server (default: 3306)
settings.sql.db: database name to use (default: RPGRegions)
settings.sql.user: username to connect with (default: user)
settings.sql.password: password to connect with (default: pass)
settings.server.gui.*: individual gui pane settings
- The integration will be set automatically to whatever plugin can be found on your server, however will fallback to WorldGuard if no others are found.
¶ Default discovery settings
You can find out how to format dates here.
settings.server.discoveries.date.format: format of dates shown to users
settings.server.discoveries.discovered.title.fadein: title fadein time (Ticks)
settings.server.discoveries.discovered.title.stay: title stay time (Ticks)
settings.server.discoveries.discovered.title.fadeout: title fadeout time (Ticks)
settings.server.discoveries.discovered.sound.name: default sound to play
settings.server.discoveries.discovered.sound.pitch: pitch of sound
¶ Default language file (en_gb)
next_page: "&aNext Page"
previous_page: "&cPrevious Page"
regions: "Regions"
discovered_on: "&7Discovered on: %0"
discovered_title:
- "&d%0 discovered!"
discovered_subtitle:
- "&fKeep exploring to discover more!"
already_discovered_title:
- "&d%0 entered!"
already_discovered_subtitle:
- "&fAlready discovered!"
teleport: "&aClick to teleport"
cannot_teleport: "&cWe can't teleport you because that world doesn't exist!"
unknown_region: "Unknown Realm"
exit: "&cExit"
cannot_enter: "&cYou require %0 to enter this area."
previous_page_lore:
- "&fGo to the previous page"
next_page_lore:
- "&fGo to the next page"
exit_lore:
- "&fExit the GUI"
cooldown: "&cThat is currently on cooldown."
MiniMessage support is currently temporarily disabled whilst we work out some problems.
RPGRegions has support for MiniMessage. You can find out how to utilise for RGB colours this at their documentation page: https://docs.adventure.kyori.net/minimessage.html.
MiniMessage support is still work in progress and some messages may not support it yet. Please let us know if you find a translation key that does not support MiniMessage.
¶ Reward types
See api for making your own rewards.
- PlayerCommandReward
- ConsoleCommandReward
- ExperienceReward
- ItemReward
- MessageReward
- MoneyReward
¶ External reward types
These are rewards served by external plugins.
¶ NT-Rpg
- cz.neumimto.rpg.spigot.bridges.RpgRegionsClassExpReward
¶ Effect types
See api for making your own effects.
- PotionRegionEffect
¶ Requirement types (beta)
See api for making your own requirements.
- AlonsoLevelRequirement
- LevelRequirement
- DependencyRequirement
- MoneyRequirement
- PlaceholderRequirement
¶ IconCommand's
An IconCommand looks like the following in your json files:
"iconCommand": [
{
"command": "say",
"clickType": "DISCOVERED",
"cooldown": 0
},
{
"command": "say command2",
"clickType": "UNDISCOVERED",
"cooldown": 0
}
]
The "command" value is the command to execute (supports placeholders), the "clickType" value is whether to run this command when clicked when the region is DISCOVERED by the player or UNDISCOVERED. The "cooldown" is how long, in ticks, a player has to wait to execute this command again.
¶ Region configs (.json)
Region configs are defined in a json file. These can be found under plugins/RPGRegions/regions/. An example file is created and updated every time the plugin starts (exampleconfig.json);
{
"world": null, // Replaced with the UUID of the world. DO NOT CHANGE
"id": "exampleconfig", // ID of the region for your integration. DO NOT CHANGE
"customName": "ExampleConfig",
"rewards": [
{
"type": "net.islandearth.rpgregions.rewards.ExperienceReward",
"properties": {
"xp": 10
}
},
{
"type": "net.islandearth.rpgregions.rewards.ItemReward",
"properties": {
"item": {
"v": 2230,
"type": "IRON_BARS"
}
}
},
{
"type": "net.islandearth.rpgregions.rewards.PlayerCommandReward",
"properties": {
"command": "say I discovered a region!"
}
},
{
"type": "net.islandearth.rpgregions.rewards.ConsoleCommandReward",
"properties": {
"command": "say Server sees you discovered a region!"
}
},
{
"type": "net.islandearth.rpgregions.rewards.MessageReward",
"properties": {
"messages": [
"\u0026aExample message as a reward"
]
}
}
],
"sound": "AMBIENT_UNDERWATER_EXIT",
"icon": "WOODEN_AXE",
"undiscoveredIcon": "WOODEN_AXE",
"iconCommand": [
{
"command": "say",
"clickType": "DISCOVERED",
"cooldown": 0
}
]
"showCoords": false,
"location": {
"world": "world",
"x": -29.32539472764756,
"y": 63.74238918554421,
"z": 202.30000001192093,
"pitch": 2.5895422,
"yaw": -191.88243
},
"hints": [],
"showHint": false,
"teleportable": false,
"hidden": false,
"discoverable": true,
"effects": [
{
"type": "net.islandearth.rpgregions.effects.PotionRegionEffect",
"properties": {
"potionEffect": {
"type": "GLOWING",
"duration": 100,
"amplifier": 1,
"ambient": true,
"particles": true,
"icon": true
},
"wearingRequired": true,
"ignoreItems": [
{
"v": 2230,
"type": "IRON_CHESTPLATE"
}
],
"ignorePerm": true
}
}
],
"requirements": [
{
"type": "net.islandearth.rpgregions.requirements.LevelRequirement",
"properties": {
"level": 5,
"preventType": "TELEPORT"
}
}
],
"discoveredLore": [],
"alwaysShowTitles": false,
"title": null,
"subtitle": null,
"discoveredTitle": null,
"discoveredSubtitle": null,
"regenerate": {
"regenerateInterval": 5000,
"loadChunks": false,
"regeneratingEntities": [
{
"entityType": "SHULKER",
"validSpawnSurfaces": [
"PURPUR_BLOCK",
"PURPUR_PILLAR"
],
"maxPerChunk": 5,
"rarity": 30
}
]
},
"teleportCooldown": 0
}
This file cannot be edited and will not be loaded at start.
This file will contain every single reward option available, so you can add them manually into your region configurations.
To automatically add reward configurations, there are some commands available.