SpigotVIP Races of Thana・Custom GUI, Attributes, Day & Night Effects and more! 3.1.8

Add a MMORPG feel to your server by adding races to your server with endless customization!





Races of Thana was created to bring a more realistic RPG-feel to Minecraft in the form of truly custom races as opposed to just the addition of potion effects as a permanent passive, and a set of permissions.

Some of the core features include but are not limited to:

• Custom Races
  • Truly custom races. Give every race their own set of attributes, passive effects, day & night effects, permissions, sounds, and much more!
  • By being able to trigger things on time (day / night events), it has never before become easier to change the skin of people from a certain race.
• Your own Race Selection GUI
  • By being in full control of what the Race Selection GUI looks like, you can make it fit to your server's style.
  • You can limit who's able to see certain races, effectively limiting the races they can choose from. Great for progression-based servers, but also as a perk!
  • You can even set up a NPC which will take in a token and allow you to change your race.
• Extremely easy to use & understand
  • With a single drag & drop, you'd already be good to go. To customize your races, simply modify the configuration file(s) as you'd like and type /races reload. That's it, literally.
  • Extensive explanations are down below. It has all the information you need.
  • In need of support? I'd love to help you out via the Discord server or discussion thread.

Hard Dependencies: Citizens (Race Tokens / Race-Changer NPC), Vault
Soft Dependencies: PlaceholderAPI (Placeholders)



MythicMobs support: Able to check race within MM's configuration by using a custom condition
Exclusive Armor-specific Addon: Will address item restrictions / limitations per race.
Race experience: Upgrade-able races, gain experience by doing various things per race.



<> = mandatory arguments || [] = optional arguments
Code (Text):
/races - Main command
/races gui [player] - Pops up the race-selection gui for a player
/races token [player] - Gives a player a race-token to hand to the npc
/races inspect [player] - Check what race a player is
/races preview - Preview the Race Selection GUI
/races reload - Reload configuration
/setrace <player> <race> - Set someone's race
/racechat <message> - Talk to other online players of your race
/races about - Details about the Races of Thana
Aliases: [traces, thanar, thanaraces, racesofthana, rot, races, race]




May there be lack of clarity in 1 of the configuration files, please let me know here!
Click here to view the default configuration file (config.yml).

Language Config (lang.yml):
Code (YAML):
prefix: "&9Races of Thana&c:"
refund-token: "&cYou were given back your token!"
give-wrong-item: "&cThat is not a race-token!"
teleport-race-spawn: "&cYou have been teleported!"
PvP Config (pvpconfig.yml):
Code (YAML):
# --------------------------- #
# Races of Thana // Thana #
# --------------------------- #

pvp-module-enabled: false

races:
werewolf:
enabled: false
allies: example1,example2
human:
enabled: false
allies: example1,example2


Code (YAML):
permissions:
racesofthana.gui:
default: op
racesofthana.gui.others:
default: op
racesofthana.racechat:
default: true
racesofthana.reload:
default: op
racesofthana.setrace:
default: op
racesofthana.setspawn:
default: op
racesofthana.spawn:
default: true
racesofthana.spawn.override:
default: op
racesofthana.token:
default: op
racesofthana.token.use:
default: true
racesofthana.inspect:
default: true
racesofthana.inspect.others:
default: op
racesofthana.preview:
default: true
racesofthana.about:
default: true
The permission-node per race is racesofthana.race.<racename>
So for example, a kitsune would need: racesofthana.race.kitsune

While this value is set to true, players will not see the races they don't have permissions to within the GUI.
(Operators and users with * permissions will see it at all times)

Did everything work the way you wanted? Do you perhaps have a problem with the config, or do you need help with making a race?
Join my Discord Community to get help and get all the latest information about the Races of Thana!



Placeholders (PlaceholderAPI Support):
Player's race: %racesofthana_player_race%
Displayname of the player's race: %racesofthana_player_race_displayname%

Config command placeholders:
- %player_name%
- %player_displayname%
- %player_race%
- %player_race_displayname%

Race GUI Menu
Supports NBT Data, Custom Flags, and Durability Values for those of you wishing to make custom Resource packs for your Race GUI Menus.

Permissions
Permission Handler that is compatible with LuckPerms, supporting negative/false perms.

Passive Effects
Effects that are always active on you at all times. Regardless of time, or day (Toggleable).

Per-race Permissions
You have the possibility to restrict players from selecting (and seeing) certain races within the race-selection GUI (Toggleable).

Language File
Able to change the messages as you wish, very self-explanatory.

Attributes
You can give each race their own set of attributes. All attributes can be found here.
Adding an attribute is as simple as adding it to a list along with a value:
Code (YAML):
attributes:
- generic_max_health: 18
- generic_attack_speed: 8
Day & Night Effects
You want effects that only activate at night, or during the day? Go ahead. You can give your custom race Night Vision ONLY during the night, and Strength ONLY during the day if you'd like. This removes the pesky problem of having Night Vision during the day, which can be really annoying as well as give you even more detailed customization to your race you'd like to make! (Toggleable).

Force Race
If you'd like your players to select a race upon joining, you can make that happen by simply setting force-race-on-join to true in the config.yml.
If you don't, that's fine too. I won't judge you.

Hurt Sounds
Custom race sounds! Are you a catlike creature and meow when being hit? Set it to ENTITY_CAT_HURT. Want your Werewolf to sound like a Wolf instead? Use ENTITY_WOLF_HURT instead!
The hurting sound can be changed per race to give you the feeling of actually being that race as specified in the config according to the sound you chose.
Default value is set to the default player hurt sound.

Death Sounds
Depending on which race you are, you can have your own death-sound as well! Catlike creatures could play the ocelot's death sound, while others have the death sound of a dragon. Cool, right?
Default value is set to the default player death sound.
A list of all compatible Entity Sounds can be found here.

Commands Executed Upon Changing / Choosing your Race
Upon race selection, you can execute self-defined commands depending on which race they've become.
You can use commands from any plugins and execute them here too. Everything from starter kits, to just helpful information. All is open. (Toggleable)

Commands Executed Upon Day- / Night-time
For example, do you have a plugin like LibsDisguises? Or another plugin that compliments a Race you've specifically made in your config file? Use this to your advantage. A wonderful example would be changing a Werewolf Race's skin, to that of an actual Werewolf at night time, instead of just keeping your basic skin on all the time.
Change back into your original skin once daylight has come to give the feel that you're actually changing into a Werewolf. (Toggleable)

This is just a small example of what you COULD do with the day- and night-based commands. There are so many possibilities. From giving Bonus Effects for a specific amount of time to disabling a Race's ability to fight in the dark with a PvP plugin.

Race Tokens
These are items that can be used to change your Race. You can have a predetermined amount of these items be required to change your race. You could have 1 Token, or you could require 5 tokens to change your race. These "tokens" are physical items which you can modify to your own likings in the config.

Tokens also support Durability & Item-Flags to further customize the look and feel of your token.

This also supports Citizens 2 with a custom race trait that allows you to specifically make a NPC take your race-token from you, to grant you a race-change without the need of a plugin to assign the NPC a command. Making the RPG-experience so much better, instead of using a command to redeem your race token if you dislike doing so.

You can do this by making a NPC and assigning it the racechanger trait. (/trait racechanger) This will take the token from the player and open the race-selection GUI for the player to change their race.

You can enable / disable the race tokens inside the config by setting race-token-enabled to either true (enable) or false (disable).

PvP Module
Player combat can go the way you want when it comes to races facing other races.
With the simple but powerful config stated above, you can now make allies!

We'll go through the config step by step:
Code (YAML):
pvp-module-enabled: true/false
Do you want to enable this module / feature? If disabled, it'll ignore everything else.

Code (YAML):
races:
werewolf: // The race you're modifying
enabled: false // Whether or not this particular section (per race) should be enabled or not (false by default)
allies: "example1,example2" // The race(s) it'll be unable to hit divided by a comma
If race 1 has race 2 as ally, but race 2 doesn't have race 1 as ally, race 1 won't be able to attack race 2, but race 2 will still be able to attack race 1!

GUI customization & Word of Knowledge
The GUI is a really detailed part of this plugin. It makes creating races as simple as it can possibly be, or as detailed as you possibly can imagine.

Here is a general look on how GUI-Specific things work:

- Enchantments
You're able to put enchantments on the items within the GUI. This can also be hidden using the HIDE_ENCHANTS item-flag (covered below)

- Item-Flags:
Allows you to set flags on any item in the GUI. HIDE_ENCHANTS, HIDE_ATTRIBUTES, etc. HIDE_ATTRIBUTES would hide the item's attributes that it has Mending, or Sharpness on the GUI item. That would look bad to your players. What this ALSO can do, is HIDE durability values (Read further for more information regarding that). We have 2 custom flags, which are "GLOWING" and "UNBREAKABLE". GLOWING gives the item a random enchantment and hides the enchantments, meaning that it'll look like a glowing item. UNBREAKABLE simply sets the item to an unbreakable state, meaning that it'll hide durability. (Handy for custom packs!)

- Durability:
Allows you to set a durability value to any item in the GUI. This opens up a world of opportunity to you artists out there making custom Resource Packs, to make your GUI items look the way you want them too. With the HIDE_ATTRIBUTES, MENDING, UNBREAKABLE and HIDE_UNBREAKABLE, the GUI would show an item that has the look of an enchanted item, while hiding the fact that it has a durability value, as well as hiding the "UNBREAKABLE, MENDING" words on the item itself. Leaving you open to make the GUI icon look cleaner.

If you are not going to be using a custom resource pack, you can ignore the durability part altogether, and just use HIDE_ATTRIBUTES, and a random enchantment of your choice.

Do you like Races of Thana? Then you should try out these other suggested plugins that would work in function with races, to make your server feel even more unique!

elMakers Magic - Per-Race Magic Spells, as well as Classes unique to each Race. (This one is my personal favorite and I highly suggest it!)

DivineItemsRPG - A must have for most, if not all RPG-servers, along with Races of Thana, you can easily restrict your highly customizable items with this plugin!

RPGInventory - Races, Classes and levels are not enough for you? Custom Inventory System as well!

JobsReborn - So much you can do with this, you should really check it out for yourself.

Heroes - Has permission-based skills. Give your Races the ability to change to specific classes, while restricting others. Gain more, or less EXP based on what Race you are, based on what monster you are killing. Unique leveling system and more!

QuestCreator - Require the player to have a certain race. Amazing for race-based quests.

My other projects that compliment RacesOfThana:

LoreAttributesRecoded
Another one of my plugins, and best of all it's free! Make your own Custom Armor, Weapons, and Items all based on lore! It compliments RacesOfThana exponentially!



By purchasing / using this plugin, you agree to the terms below.

• When you have an issue please contact me via PM before posting a bad rating. We'll resolve the issue there as soon as I possibly can.
• Ratings are not the right place for suggestions, requests, or bug reports.
• Poor Ratings that do not follow legitimate rating guidelines will not receive plugin support.
• By buying the resource you agree that you have read the whole description.
• No refunds.
• You may not -Redacted- the RacesOfThana plugin or any of its source code publicly or privately.
• Support is only given to accounts who bought the resource referencing the above rules.
• You will never have to re-pay for support, or additional features added. Add-ons are the exception.
• The terms of service can be modified at any time, at my sole discretion.