HotelRoom - 领土 × 种族进化 RPG 插件
? 插件概览
HotelRoom 是一款专为 Minecraft Paper 服务器打造的高品质 RPG 增强插件,完美融合了领土管理与种族进化系统。玩家可以在建设家园的同时体验不同种族的独特成长路径,营造出身临其境的生存冒险体验。
✨ 核心功能
? 领土系统
完整的领土管理系统,包含三种领土类型:
| 类型 |
描述 |
使用场景 |
| 私人领土 |
玩家专属的私有空间,拥有完全保护 |
个人住宅、私人仓库 |
| 公共领土 |
多人共享区域,可被认领 |
公寓楼、社区住房 |
| 官方领土 |
由服务器官方管理的区域 |
商店、办公区、公共设施 |
主要特性:
- ? 完整的方块保护机制
- ? 成员权限管理
- ? 荣誉阈值设置
- ? 自动快照外观,重启后自动恢复
- ?️ 直观的 GUI 导航界面
? 种族进化系统
丰富的种族系统,为每位玩家提供独特的成长路径:
种族特性:
- ? 多种族选择(人类、精灵、矮人等)
- ? 等级成长系统,属性随等级提升而增加
- ? 种族进化路径,解锁新能力
- ? 种族专属的外观变化
- ?️ 种族专属语音聊天频道
成长机制:
- 击杀怪物以获取种族经验
- 完成任务以获得额外经验奖励
- 种族进化解锁强大技能
⚔️ 自定义属性系统
强大的属性系统,支持 20+ 种属性:
攻击属性:
| 属性 |
描述 |
| 物理伤害 |
增加普通攻击伤害 |
| 魔法伤害 |
增加魔法攻击伤害 |
| 暴击率 |
触发暴击的概率 |
| 暴击伤害 |
暴击时的伤害倍率 |
| 物理穿透 |
无视目标护甲值 |
| 魔法穿透 |
无视目标魔法防御 |
防御属性:
| 属性 |
描述 |
| 物理防御 |
减少受到的物理伤害 |
| 魔法防御 |
减少受到的魔法伤害 |
| 护甲值 |
基础护甲减伤比例 |
| 闪避率 |
完全闪避攻击的概率 |
| 格挡率 |
格挡攻击的概率 |
生存属性:
| 属性 |
描述 |
| 生命值 |
最大生命上限 |
| 生命恢复 |
每秒恢复的生命值 |
| 吸血 |
攻击时恢复生命值 |
| 法力值 |
法力上限 |
| 法力恢复 |
每秒恢复的法力值 |
实用属性:
| 属性 |
描述 |
| Movement Speed |
移动速度加成 |
| Attack Speed |
攻击频率加成 |
| Cooldown Reduction |
技能冷却缩减 |
| EXP Bonus |
经验获取增加 |
| Drop Bonus |
物品掉落率提升 |
装备属性:
- 支持在物品 Lore(描述)中添加属性
- 穿戴装备时自动生效
- 支持百分比和固定数值加成
???? 家族系统
完整的家族社交系统:
家族功能:
- ? 创建家族,建立势力
- ? 邀请成员,壮大团队
- ? 家族等级,解锁特权
- ? 家族聊天,专属频道
- ? 家族职位,权限管理
职位系统:
| 职位 |
权限 |
| Leader |
完全管理权限 |
| Deputy |
邀请/踢出成员 |
| Member |
基础家族功能 |
? 指令
领地指令
/hrlist - 打开领地列表与导航
/hotelroom [subcommand] - 主指令
/createhotel <name> [system] - 创建领地(管理员)
/createpublichotel <name> - 创建公共领地(管理员)
/createofficialhotel <type> <name> - 创建官方领地(管理员)
/givehotel <territory> <player> - 赠送领地(管理员)
/removehotel <territory> - 移除领地(管理员)
/abandon [territory] - 放弃领地
属性指令
/attr check [player] - 查看属性
/attr set <player> <attr> <value> - 设置属性(管理员)
/attr add <player> <attr> <value> - 添加属性(管理员)
/attr reset <player> - 重置属性(管理员)
/attr reload - 重载配置(管理员)
/attr item add <attr> <value> - 为物品添加属性(管理员)
/attr item remove <line> - 移除物品属性行(管理员)
/attr item list - 查看物品属性列表
种族指令
/racegui - 打开种族进化界面
/changerace <race> - 切换种族
/racevoice - 种族语音聊天
/raceexp give <player> <amount> - 给予种族经验(管理员)
/raceexp set <player> <level> - 设置种族等级(管理员)
/raceexp check <player> - 查看种族信息(管理员)
家族指令
/family - 打开家族主界面
/family create <name> - 创建家族
/family invite <player> - 邀请玩家
/family kick <player> - 踢出成员
/family leave - 退出家族
/family info - 查看家族信息
? API & PAPI 变量
PlaceholderAPI 变量
玩家相关:
%hotelroom_player_honor% - 玩家荣誉值
%hotelroom_player_health% - 当前生命值
%hotelroom_player_max_health% - 最大生命值
%hotelroom_player_health_percent% - 生命百分比
属性相关:
%hotelroom_attr_<attribute>% - 指定属性值
%hotelroom_all_attributes% - 所有属性列表
领土相关:
%hotelroom_in_land% - 是否在领土内
%hotelroom_land_name% - 当前领土名称
%hotelroom_land_owner% - 领土所有者
%hotelroom_land_honor% - 领土荣誉阈值
%hotelroom_in_public_hotel% - 是否在公共酒店
%hotelroom_public_members_count% - 公共领土成员数量
种族相关:
%hotelroom_race% - 当前种族名称
%hotelroom_race_name% - 种族内部 ID
%hotelroom_is_race_<race>% - 是否为指定种族
家族相关:
%hotelroom_family_name% - 家族名称
%hotelroom_family_position% - 家族职位
%hotelroom_family_level% - 家族等级
%hotelroom_family_member_count% - 成员数量
生物相关:
%hotelroom_mob_health% - 目标生物当前生命值
%hotelroom_mob_max_health% - 目标生物最大生命值
%hotelroom_mob_health_percent% - 目标生物生命百分比
%hotelroom_mob_name% - 目标生物名称
开发者 API
// 获取属性管理器
AttributeManager manager = AttributeManager.getInstance();
// 获取玩家属性
PlayerAttribute attr = manager.getPlayerAttribute(player.getUniqueId());
double damage = attr.getAttribute("physical_damage");
// 设置玩家属性
manager.setPlayerAttributeValue(uuid, "physical_damage", 50.0);
manager.refreshPlayerAttributes(player);
// 获取领土信息
HotelInfo hotel = SelectionMgr.HOTELS.get("territory_name");
if (hotel != null) {
UUID owner = hotel.owner;
boolean isPublic = hotel.isPublic;
Location[] corners = hotel.corners;
}
// 检查玩家是否在领土内
HotelInfo currentHotel = ProtectionListener.getHotelAt(player.getLocation());
⚙️ 配置文件
文件结构
plugins/HotelRoom/
├── config.yml # 主配置文件
├── hotels.db # SQLite 数据库
├── attributes/
│ └── attributes.yml # 属性系统配置
└── races/
├── human.yml # 人类种族配置
├── elf.yml # 精灵种族配置
└── dwarf.yml # 矮人种族配置
自定义属性配置
custom-attributes:
true_damage:
display-name: "§c⚡ 真实伤害"
default-value: 0.0
min-value: 0.0
max-value: 1000.0
type: offensive
trigger: on_attack
formula: "damage + {true_damage}"
ignore-defense: true
description: "造成无视防御的额外伤害"
? 权限
| 权限 |
描述 |
默认值 |
hotelroom.admin |
管理员权限 |
OP |
hotelroom.attr.others |
查看他人属性 |
OP |
hotelroom.race.gui |
使用种族进化 GUI |
所有人 |
hr.family.use |
使用家族系统 |
所有人 |
hr.family.create |
创建家族 |
所有人 |
hr.family.admin |
家族管理 |
OP |
hr.family.invite |
邀请家族成员 |
OP |
hr.family.kick |
踢出家族成员 |
OP |
? 安装指南
要求
- 服务器: Paper 1.21.4 或更高版本
- Java: JDK 21 或更高版本
- 可选依赖项:
- PlaceholderAPI(推荐)
- MythicMobs(可选)
- CustomMoney(可选)
安装步骤
- 下载最新的 HotelRoom.jar
- 将文件放入服务器的
plugins 文件夹中
- 启动服务器,等待配置文件生成
- 根据需要修改配置文件
- 使用
/attr reload 重新加载配置或重启服务器
HotelRoom - Territory × Race Evolution RPG Plugin
? Plugin Overview
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.
✨ Core Features
? Territory System
Complete territory management system with three territory types:
| Type |
Description |
Use Case |
| Private Territory |
Player's exclusive private space with full protection |
Personal residence, private storage |
| Public Territory |
Multi-player shared area, claimable |
Apartment buildings, community housing |
| Official Territory |
Server official managed areas |
Shops, office areas, public facilities |
Key Features:
- ? Complete block protection mechanism
- ? Member permission management
- ? Honor threshold settings
- ? Auto facade snapshot, auto-restore after restart
- ?️ Intuitive GUI navigation interface
? Race Evolution System
Rich race system giving each player a unique growth path:
Race Features:
- ? Multiple race choices (Human, Elf, Dwarf, etc.)
- ? Level growth system, attributes increase with level
- ? Race evolution paths, unlock new abilities
- ? Race-exclusive appearance changes
- ?️ Race-exclusive voice chat channel
Growth Mechanics:
- Kill monsters to gain race experience
- Complete quests for bonus experience rewards
- Race evolution unlocks powerful skills
⚔️ Custom Attribute System
Powerful attribute system supporting 20+ attributes:
Offensive Attributes:
| Attribute |
Description |
| Physical Damage |
Increases normal attack damage |
| Magic Damage |
Increases magic attack damage |
| Crit Rate |
Probability of triggering critical hit |
| Crit Damage |
Damage multiplier on critical hit |
| Armor Penetration |
Ignores target armor value |
| Magic Penetration |
Ignores target magic defense |
Defensive Attributes:
| Attribute |
Description |
| Physical Defense |
Reduces physical damage taken |
| Magic Defense |
Reduces magic damage taken |
| Armor Value |
Base armor damage reduction |
| Dodge Rate |
Probability of completely dodging attack |
| Block Rate |
Probability of blocking attack |
Survival Attributes:
| Attribute |
Description |
| Health |
Maximum health cap |
| Health Regen |
Health restored per second |
| Lifesteal |
Restore health on attack |
| Mana |
Mana cap |
| Mana Regen |
Mana restored per second |
Utility Attributes:
| Attribute |
Description |
| Movement Speed |
Movement speed bonus |
| Attack Speed |
Attack frequency bonus |
| Cooldown Reduction |
Skill cooldown reduction |
| EXP Bonus |
Increased experience gain |
| Drop Bonus |
Item drop rate increase |
Equipment Attributes:
- Support adding attributes in item Lore
- Auto-apply when equipment is worn
- Support percentage and fixed value bonuses
???? Family System
Complete family social system:
Family Features:
- ? Create family, establish power
- ? Invite members, grow team
- ? Family level, unlock privileges
- ? Family chat, exclusive channel
- ? Family positions, permission management
Position System:
| Position |
Permissions |
| Leader |
Full management permissions |
| Deputy |
Invite/kick members |
| Member |
Basic family features |
? Commands
Territory Commands
/hrlist - Open territory list and navigation
/hotelroom [subcommand] - Main command
/createhotel <name> [system] - Create territory (Admin)
/createpublichotel <name> - Create public territory (Admin)
/createofficialhotel <type> <name> - Create official territory (Admin)
/givehotel <territory> <player> - Gift territory (Admin)
/removehotel <territory> - Remove territory (Admin)
/abandon [territory] - Abandon territory
Attribute Commands
/attr check [player] - Check attributes
/attr set <player> <attr> <value> - Set attribute (Admin)
/attr add <player> <attr> <value> - Add attribute (Admin)
/attr reset <player> - Reset attributes (Admin)
/attr reload - Reload config (Admin)
/attr item add <attr> <value> - Add attribute to item (Admin)
/attr item remove <line> - Remove item attribute (Admin)
/attr item list - View item attribute list
Race Commands
/racegui - Open race evolution interface
/changerace <race> - Change race
/racevoice - Race voice chat
/raceexp give <player> <amount> - Give race experience (Admin)
/raceexp set <player> <level> - Set race level (Admin)
/raceexp check <player> - Check race info (Admin)
Family Commands
/family - Open family main interface
/family create <name> - Create family
/family invite <player> - Invite player
/family kick <player> - Kick member
/family leave - Leave family
/family info - View family info
? API & PAPI Variables
PlaceholderAPI Variables
Player Related:
%hotelroom_player_honor% - Player honor value
%hotelroom_player_health% - Current health
%hotelroom_player_max_health% - Max health
%hotelroom_player_health_percent% - Health percentage
Attribute Related:
%hotelroom_attr_<attribute>% - Specified attribute value
%hotelroom_all_attributes% - All attributes list
Territory Related:
%hotelroom_in_land% - Whether in territory
%hotelroom_land_name% - Current territory name
%hotelroom_land_owner% - Territory owner
%hotelroom_land_honor% - Territory honor threshold
%hotelroom_in_public_hotel% - Whether in public hotel
%hotelroom_public_members_count% - Public territory member count
Race Related:
%hotelroom_race% - Current race name
%hotelroom_race_name% - Race internal ID
%hotelroom_is_race_<race>% - Whether specified race
Family Related:
%hotelroom_family_name% - Family name
%hotelroom_family_position% - Family position
%hotelroom_family_level% - Family level
%hotelroom_family_member_count% - Member count
Mob Related:
%hotelroom_mob_health% - Targeted mob current health
%hotelroom_mob_max_health% - Targeted mob max health
%hotelroom_mob_health_percent% - Targeted mob health percentage
%hotelroom_mob_name% - Targeted mob name
Developer API
// Get attribute manager
AttributeManager manager = AttributeManager.getInstance();
// Get player attributes
PlayerAttribute attr = manager.getPlayerAttribute(player.getUniqueId());
double damage = attr.getAttribute("physical_damage");
// Set player attribute
manager.setPlayerAttributeValue(uuid, "physical_damage", 50.0);
manager.refreshPlayerAttributes(player);
// Get territory info
HotelInfo hotel = SelectionMgr.HOTELS.get("territory_name");
if (hotel != null) {
UUID owner = hotel.owner;
boolean isPublic = hotel.isPublic;
Location[] corners = hotel.corners;
}
// Check if player is in territory
HotelInfo currentHotel = ProtectionListener.getHotelAt(player.getLocation());
⚙️ Configuration Files
File Structure
plugins/HotelRoom/
├── config.yml # Main config file
├── hotels.db # SQLite database
├── attributes/
│ └── attributes.yml # Attribute system config
└── races/
├── human.yml # Human race config
├── elf.yml # Elf race config
└── dwarf.yml # Dwarf race config
Custom Attribute Configuration
custom-attributes:
true_damage:
display-name: "§c⚡ True Damage"
default-value: 0.0
min-value: 0.0
max-value: 1000.0
type: offensive
trigger: on_attack
formula: "damage + {true_damage}"
ignore-defense: true
description: "Deals defense-ignoring extra damage"
? Permissions
| Permission |
Description |
Default |
hotelroom.admin |
Admin permission |
OP |
hotelroom.attr.others |
View others' attributes |
OP |
hotelroom.race.gui |
Use race evolution GUI |
Everyone |
hr.family.use |
Use family system |
Everyone |
hr.family.create |
Create family |
Everyone |
hr.family.admin |
Family admin |
OP |
hr.family.invite |
Invite family members |
OP |
hr.family.kick |
Kick family members |
OP |
? Installation Guide
Requirements
- Server: Paper 1.21.4 or higher
- Java: JDK 21 or higher
- Optional Dependencies:
- PlaceholderAPI (Recommended)
- MythicMobs (Optional)
- CustomMoney (Optional)
Installation Steps
- Download the latest HotelRoom.jar
- Place the file in server's
plugins folder
- Start server, wait for config files to generate
- Modify config files as needed
- Use
/attr reload to reload config or restart server
评论 0
登录后参与评分
还没有评论,来抢沙发吧