Sign In Register
HotelsX Icon

HotelsX

Manage player-owned hotels on your Minecraft server — rooms, pricing, check-ins, Vault payments, and rotatable decoration presets. Folia & Paper compatible. 为你的 Minecraft 服务器管理玩家自营酒店 —— 房间、定价、入住、Vau

30.7K downloads • 2 followers • Adventure & RPG • Modrinth

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

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 <1-5> [评语] | 给自己住过的房间评分 |

| /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 <1-5> [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

Advertisement