# HotelRoom – Territory \u00d7 Race Evolution RPG Plugin<\/p>\n
—<\/p>\n
## \ud83d\udccc Plugin Overview<\/p>\n
**HotelRoom** is a high-quality RPG enhancement plugin designed for Minecraft Paper servers, perfectly combining **Territory Management** with **Race Evolution System**. Players can build their homes while experiencing unique growth paths of different races, creating an immersive survival adventure experience.<\/p>\n
—<\/p>\n
## \u2728 Core Features<\/p>\n
### \ud83c\udfe0 Territory System<\/p>\n
Complete territory management system with three territory types:<\/p>\n
| Type | Description | Use Case |
\n|——|————-|———-|
\n| **Private Territory** | Player’s exclusive private space with full protection | Personal residence, private storage |
\n| **Public Territory** | Multi-player shared area, claimable | Apartment buildings, community housing |
\n| **Official Territory** | Server official managed areas | Shops, office areas, public facilities |<\/p>\n
**Key Features**:
\n– \ud83d\udd12 Complete block protection mechanism
\n– \ud83d\udc65 Member permission management
\n– \ud83c\udfc6 Honor threshold settings
\n– \ud83d\udcbe Auto facade snapshot, auto-restore after restart
\n– \ud83d\uddfa\ufe0f Intuitive GUI navigation interface<\/p>\n
—<\/p>\n
### \ud83e\uddec Race Evolution System<\/p>\n
Rich race system giving each player a unique growth path:<\/p>\n
**Race Features**:
\n– \ud83e\udddd Multiple race choices (Human, Elf, Dwarf, etc.)
\n– \ud83d\udcc8 Level growth system, attributes increase with level
\n– \ud83d\udd04 Race evolution paths, unlock new abilities
\n– \ud83c\udfa8 Race-exclusive appearance changes
\n– \ud83c\udf99\ufe0f Race-exclusive voice chat channel<\/p>\n
**Growth Mechanics**:
\n– Kill monsters to gain race experience
\n– Complete quests for bonus experience rewards
\n– Race evolution unlocks powerful skills<\/p>\n
—<\/p>\n
### \u2694\ufe0f Custom Attribute System<\/p>\n
Powerful attribute system supporting 20+ attributes:<\/p>\n
**Offensive Attributes**:
\n| Attribute | Description |
\n|———–|————-|
\n| Physical Damage | Increases normal attack damage |
\n| Magic Damage | Increases magic attack damage |
\n| Crit Rate | Probability of triggering critical hit |
\n| Crit Damage | Damage multiplier on critical hit |
\n| Armor Penetration | Ignores target armor value |
\n| Magic Penetration | Ignores target magic defense |<\/p>\n
**Defensive Attributes**:
\n| Attribute | Description |
\n|———–|————-|
\n| Physical Defense | Reduces physical damage taken |
\n| Magic Defense | Reduces magic damage taken |
\n| Armor Value | Base armor damage reduction |
\n| Dodge Rate | Probability of completely dodging attack |
\n| Block Rate | Probability of blocking attack |<\/p>\n
**Survival Attributes**:
\n| Attribute | Description |
\n|———–|————-|
\n| Health | Maximum health cap |
\n| Health Regen | Health restored per second |
\n| Lifesteal | Restore health on attack |
\n| Mana | Mana cap |
\n| Mana Regen | Mana restored per second |<\/p>\n
**Utility Attributes**:
\n| Attribute | Description |
\n|———–|————-|
\n| Movement Speed | Movement speed bonus |
\n| Attack Speed | Attack frequency bonus |
\n| Cooldown Reduction | Skill cooldown reduction |
\n| EXP Bonus | Increased experience gain |
\n| Drop Bonus | Item drop rate increase |<\/p>\n
**Equipment Attributes**:
\n– Support adding attributes in item Lore
\n– Auto-apply when equipment is worn
\n– Support percentage and fixed value bonuses<\/p>\n
—<\/p>\n
### \ud83d\udc68\u200d\ud83d\udc69\u200d\ud83d\udc67\u200d\ud83d\udc66 Family System<\/p>\n
Complete family social system:<\/p>\n
**Family Features**:
\n– \ud83c\udff0 Create family, establish power
\n– \ud83d\udc65 Invite members, grow team
\n– \ud83d\udcca Family level, unlock privileges
\n– \ud83d\udcac Family chat, exclusive channel
\n– \ud83c\udfaf Family positions, permission management<\/p>\n
**Position System**:
\n| Position | Permissions |
\n|———-|————-|
\n| Leader | Full management permissions |
\n| Deputy | Invite\/kick members |
\n| Member | Basic family features |<\/p>\n
—<\/p>\n
## \ud83c\udfae Commands<\/p>\n
### Territory Commands<\/p>\n
“` ### Attribute Commands<\/p>\n “` ### Race Commands<\/p>\n “` ### Family Commands<\/p>\n “` —<\/p>\n ## \ud83d\udd0c API & PAPI Variables<\/p>\n ### PlaceholderAPI Variables<\/p>\n **Player Related**: **Attribute Related**: **Territory Related**: **Race Related**: **Family Related**: **Mob Related**: ### Developer API<\/p>\n “`java \/\/ Get player attributes \/\/ Set player attribute \/\/ Get territory info \/\/ Check if player is in territory —<\/p>\n ## \u2699\ufe0f Configuration Files<\/p>\n ### File Structure<\/p>\n “` ### Custom Attribute Configuration<\/p>\n “`yaml —<\/p>\n ## \ud83d\udccb Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ## \ud83d\udce5 Installation Guide<\/p>\n ### Requirements<\/p>\n – **Server**: Paper 1.21.4 or higher ### Installation Steps<\/p>\n 1. Download the latest HotelRoom.jar —<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":" Territory \u00d7 Race Evolution, creating immersive RPG survival experience.<\/p>\n","protected":false},"featured_media":128187,"template":"","meta":{"_minecraft_slug":"racial_town","_minecraft_project_id":"z32cLVB2","_minecraft_author":"JSGDJD","_minecraft_license":"Apache-2.0","_minecraft_downloads":16,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"racial_town.zip","_minecraft_size_bytes":367330,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:47:16.855517Z","_minecraft_date_created":"2026-02-28T02:27:49.014888Z","_minecraft_date_modified":"2026-02-23T06:08:57.553029Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/racial_town","_minecraft_icon_attachment_id":128187,"_minecraft_imported_at":"2026-06-07T13:07:05+00:00","_minecraft_import_hash":"97bad747ce5adb4a8f36da3c84da80c6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,88,126,127,867,129,91,159],"mod_loader":[132,134],"minecraft_version":[38],"class_list":["post-128186","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-equipment","mod_category-management","mod_category-paper","mod_category-social","mod_category-spigot","mod_category-storage","mod_category-worldgen","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21-4"],"yoast_head":"\n
\n\/hrlist – Open territory list and navigation
\n\/hotelroom [subcommand] – Main command
\n\/createhotel
\n\/createpublichotel
\n\/createofficialhotel
\n\/givehotel
\n\/removehotel
\n\/abandon [territory] – Abandon territory
\n“`<\/p>\n
\n\/attr check [player] – Check attributes
\n\/attr set
\n\/attr add
\n\/attr reset
\n\/attr reload – Reload config (Admin)
\n\/attr item add
\n\/attr item remove
\n\/attr item list – View item attribute list
\n“`<\/p>\n
\n\/racegui – Open race evolution interface
\n\/changerace
\n\/racevoice – Race voice chat
\n\/raceexp give
\n\/raceexp set
\n\/raceexp check
\n“`<\/p>\n
\n\/family – Open family main interface
\n\/family create
\n\/family invite
\n\/family kick
\n\/family leave – Leave family
\n\/family info – View family info
\n“`<\/p>\n
\n“`
\n%hotelroom_player_honor% – Player honor value
\n%hotelroom_player_health% – Current health
\n%hotelroom_player_max_health% – Max health
\n%hotelroom_player_health_percent% – Health percentage
\n“`<\/p>\n
\n“`
\n%hotelroom_attr_
\n%hotelroom_all_attributes% – All attributes list
\n“`<\/p>\n
\n“`
\n%hotelroom_in_land% – Whether in territory
\n%hotelroom_land_name% – Current territory name
\n%hotelroom_land_owner% – Territory owner
\n%hotelroom_land_honor% – Territory honor threshold
\n%hotelroom_in_public_hotel% – Whether in public hotel
\n%hotelroom_public_members_count% – Public territory member count
\n“`<\/p>\n
\n“`
\n%hotelroom_race% – Current race name
\n%hotelroom_race_name% – Race internal ID
\n%hotelroom_is_race_
\n“`<\/p>\n
\n“`
\n%hotelroom_family_name% – Family name
\n%hotelroom_family_position% – Family position
\n%hotelroom_family_level% – Family level
\n%hotelroom_family_member_count% – Member count
\n“`<\/p>\n
\n“`
\n%hotelroom_mob_health% – Targeted mob current health
\n%hotelroom_mob_max_health% – Targeted mob max health
\n%hotelroom_mob_health_percent% – Targeted mob health percentage
\n%hotelroom_mob_name% – Targeted mob name
\n“`<\/p>\n
\n\/\/ Get attribute manager
\nAttributeManager manager = AttributeManager.getInstance();<\/p>\n
\nPlayerAttribute attr = manager.getPlayerAttribute(player.getUniqueId());
\ndouble damage = attr.getAttribute(“physical_damage”);<\/p>\n
\nmanager.setPlayerAttributeValue(uuid, “physical_damage”, 50.0);
\nmanager.refreshPlayerAttributes(player);<\/p>\n
\nHotelInfo hotel = SelectionMgr.HOTELS.get(“territory_name”);
\nif (hotel != null) {
\n UUID owner = hotel.owner;
\n boolean isPublic = hotel.isPublic;
\n Location[] corners = hotel.corners;
\n}<\/p>\n
\nHotelInfo currentHotel = ProtectionListener.getHotelAt(player.getLocation());
\n“`<\/p>\n
\nplugins\/HotelRoom\/
\n\u251c\u2500\u2500 config.yml # Main config file
\n\u251c\u2500\u2500 hotels.db # SQLite database
\n\u251c\u2500\u2500 attributes\/
\n\u2502 \u2514\u2500\u2500 attributes.yml # Attribute system config
\n\u2514\u2500\u2500 races\/
\n \u251c\u2500\u2500 human.yml # Human race config
\n \u251c\u2500\u2500 elf.yml # Elf race config
\n \u2514\u2500\u2500 dwarf.yml # Dwarf race config
\n“`<\/p>\n
\ncustom-attributes:
\n true_damage:
\n display-name: “\u00a7c\u26a1 True Damage”
\n default-value: 0.0
\n min-value: 0.0
\n max-value: 1000.0
\n type: offensive
\n trigger: on_attack
\n formula: “damage + {true_damage}”
\n ignore-defense: true
\n description: “Deals defense-ignoring extra damage”
\n“`<\/p>\n
\n|————|————-|———|
\n| `hotelroom.admin` | Admin permission | OP |
\n| `hotelroom.attr.others` | View others’ attributes | OP |
\n| `hotelroom.race.gui` | Use race evolution GUI | Everyone |
\n| `hr.family.use` | Use family system | Everyone |
\n| `hr.family.create` | Create family | Everyone |
\n| `hr.family.admin` | Family admin | OP |
\n| `hr.family.invite` | Invite family members | OP |
\n| `hr.family.kick` | Kick family members | OP |<\/p>\n
\n– **Java**: JDK 21 or higher
\n– **Optional Dependencies**:
\n – PlaceholderAPI (Recommended)
\n – MythicMobs (Optional)
\n – CustomMoney (Optional)<\/p>\n
\n2. Place the file in server’s `plugins` folder
\n3. Start server, wait for config files to generate
\n4. Modify config files as needed
\n5. Use `\/attr reload` to reload config or restart server<\/p>\n