HotelsX

把任意一块区域变成酒店房间

HotelsX 让玩家用木斧圈出一块地，把它变成可以收费入住的房间。
房主定价、上锁或设密码，其他玩家付费入住。

房主赚取收入，住客得到落脚处。日常使用完全不需要改配置文件，所有操作都在游戏内的 GUI 里完成。

功能

• 圈地建店 — 用选区工具（木斧）点选两个对角点，再执行 /ht create
• 上锁与密码 — 一键上锁阻止他人进入，也可以只把密码告诉指定的人
• 房主定价 — 每个房间可以单独设置入住价格
• 限时租期 — 按分钟出租，住客可用 /ht extend 续费延长
• 自动结算 — 接入 Vault 后入住自动扣款、退房自动结算；可开启托管模式，收益由房主用 /ht claim 自行提现
• 房间状态 — 空闲 / 已入住 / 维护中
• 五星评分 — 入住过的玩家可以打 1–5 分并留言，房主用 /ht ratings 查看
• 酒店合集 — 把多个房间归入一个合集，共享同一套租期
• 装修预设 — 把某个房间的建筑存为预设，一键套用到尺寸完全一致的其他房间，支持 0/90/180/270 度旋转
• 完整 GUI — 主菜单、浏览房间、房间管理、管理员面板
• 细节体验 — 铁块电梯（全局开关）、/ht tp 传送回房、可同时入住多个房间、内置操作日志

命令

命令 · 说明
/hotels、/ht · 打开主菜单
/ht wand · 获取选区工具（木斧）
/ht setspawn · 设置房间传送点
/ht create · 用当前选区创建房间
/ht remove · 删除自己的房间
/ht manage · 修改价格、密码、锁与租期
/ht list · 查看自己的房间
/ht info · 查看房间详情
/ht checkin [密码] · 入住房间
/ht checkout [ID] · 退房
/ht checkedin、/ht stays · 查看当前入住的所有房间
/ht extend · 续费延长租期
/ht rate [评语] · 给自己住过的房间评分
/ht ratings · 查看某个房间的评分
/ht tp · 传送回自己的房间
/ht claim · 提现托管收益
/ht preset list / save / apply / delete · 管理装修预设
/ht elevator · 全局开关铁块电梯（管理员）
/ht admin ... · 管理员工具

权限

权限节点 · 默认 · 说明
hotels.use · true · 使用酒店系统
hotels.create · true · 创建房间
hotels.remove · true · 删除自己的房间
hotels.admin · op · 完整管理员权限
hotels.bypass · op · 无视锁与密码入住任意房间

安装

1. （可选，推荐）安装一个兼容 Vault 的经济插件
2. 把 HotelsX-.jar 放进服务器的 plugins/ 目录
3. 重启服务器

开箱即用，无需任何额外配置。

环境要求

• Paper / Spigot / Purpur 1.21 及以上（支持 Folia）
• Java 21
• Vault 与经济插件 —— 可选，只有收费房间才需要

从源码构建

仓库自带 Maven Wrapper，不需要预先安装 Maven，只需要 JDK 21。

Windows

build.bat

Linux / macOS

chmod +x build.sh && ./build.sh

产物位于 target/。

许可证

MIT

Turn any region into a hotel

HotelsX lets players claim an area with a wooden axe and turn it into a rentable room.
Set a price, add a lock or a password, and let other players pay to check in.

Room owners earn money. Guests get a place to stay. Day-to-day use needs no config
editing at all — everything is driven from the in-game GUI.

Features

• Region claiming — Select two corners with the selection wand (a wooden axe), then run /ht create
• Locks & passwords — Lock a room to keep everyone out, or hand out a password to chosen guests
• Owner-set pricing — Every room carries its own check-in price
• Timed stays — Rent rooms by duration, and let guests extend with /ht extend
• Automatic payment — Hook up Vault and money is charged on check-in, settled on check-out. An optional escrow mode holds earnings until the owner withdraws them with /ht claim
• Room status — Available / Occupied / Maintenance
• Star ratings — Anyone who has actually stayed can rate a room 1–5 with an optional comment; owners read them back with /ht ratings
• Room collections — Group rooms into a hotel that shares one rental duration
• Decoration presets — Save a room's build as a preset and stamp it onto any identically sized room, with 0/90/180/270 rotation
• Full GUI — Main menu, room browser, room management and admin panels
• Quality of life — Iron-block elevator (one global toggle), /ht tp back to your room, check in to several rooms at once, and a built-in action log for owners and admins

Commands

Command · Description
/hotels, /ht · Open the main menu
/ht wand · Get the selection wand (wooden axe)
/ht setspawn · Set the room's teleport point
/ht create · Create a room from your current selection
/ht remove · Delete one of your rooms
/ht manage · Edit price, password, lock and duration
/ht list · List your own rooms
/ht info · Show room details
/ht checkin [password] · Check in
/ht checkout [id] · Check out
/ht checkedin, /ht stays · List every room you are currently checked into
/ht extend · Extend a timed stay
/ht rate [comment] · Rate a room you have stayed in
/ht ratings · Read the ratings of a room
/ht tp · Teleport back to your room
/ht claim · Withdraw escrow earnings
/ht preset list / save / apply / delete · Manage decoration presets
/ht elevator · Toggle the iron-block elevator globally (admin)
/ht admin ... · Admin tools

Permissions

Node · Default · Description
hotels.use · true · Use the hotel system
hotels.create · true · Create rooms
hotels.remove · true · Remove your own rooms
hotels.admin · op · Full admin access
hotels.bypass · op · Check in to any room, ignoring locks and passwords

Installation

1. (Optional but recommended) install a Vault-compatible economy plugin
2. Drop HotelsX-.jar into your plugins/ folder
3. Restart the server

That is it — no configuration required to get started.

Requirements

• Paper, Spigot or Purpur 1.21+ (Folia is supported)
• Java 21
• Vault plus an economy plugin — optional, only needed for paid rooms

Building from source

The repository ships with the Maven Wrapper, so Maven does not need to be installed.
JDK 21 is the only requirement.

Windows

build.bat

Linux / macOS

chmod +x build.sh && ./build.sh

The jar lands in target/.

License

MIT