RentIt - Shop and Hotel renting - Includes NPC Shop - RentIt - 租赁商店与酒店插件

RentIt 是一款为服务器增添 RPG 氛围的插件，允许创建可租赁的自定义商店和酒店房间区域。它包含独立的权限系统，支持完全自定义的 GUI，并与 Folia 兼容。

💡重要须知

由于这是一个全新的商店系统，其运作方式与其他插件不同，请在使用前了解以下信息。

通用机制

• 插件基于分类系统工作。你可以为多个区域轻松设置和复用分类值，并通过分类菜单（例如 /freeshops 或 /freehotels 命令）进行排序。

商店机制

• 在商店菜单中，店主或拥有购买/销售权限的玩家可以右键单击移除待售/待购物品。
• 玩家可以在商店区域内放置箱子（或拥有建造权限的玩家）。此箱子被视为存储。如果玩家想销售多种物品，可以将物品添加到商店，并在存储箱中放入更多同类物品。买家将优先从存储箱获取物品，存储箱为空后才会从商店菜单中扣除。
• 如果你想从卖家那里购买物品，同样需要一个箱子存储。购买的商品将存入商店内的所有箱子中，直到空间不足或玩家资金耗尽。你可以通过在箱子里放入商店未上架的其他物品来手动限制空间，防止购买过多。
• 商店物品需要用户自行清理。如果商店重置，物品将会消失。目前暂无更优的用户友好解决方案。

🎮命令列表

时间格式 %time% 示例：7D, 7h, 7m （请注意大小写敏感）。

RentIt 通用命令

• /rentit reload - 重载配置和 SQL 连接。

商店命令

• /shops - 显示你拥有的所有商店。
• /freeshops - 显示所有空闲商店。
• /shop help - 打开帮助手册。
• /shop createCat <categoryID> <Price> <Size> <Time> - 创建一个商店分类。
• /shop deleteCat - 删除一个分类。
• /shop listCat - 列出所有分类。
• /shop list - 列出所有商店。
• /shop setarea <categoryID> - 将选定区域设置为指定分类的商店。
• /shop setnpc - 设置或更改商店 NPC 的位置。
• /shop setprice <Price> - 更改租金价格（修改分类设置）。
• /shop setsize <Size> - 更改商店大小（修改分类设置）。
• /shop settime <Time> - 更改租赁时长（修改分类设置）。
• /shop reset - 重置商店，以便新玩家租用。
• /shop delete - 完全删除商店。
• /shop updateBackup - 为当前商店区域创建新备份。
• /shop buy <shopId> - 租赁指定 ID 的商店。
• /shop search <Item> - 在所有商店中搜索物品。
• /shop sellitem <Price> - 将手中的物品以指定价格添加到商店出售。
• /shop buyitem <Price> - 将手中的物品以指定价格添加到商店求购。
• /shop buyitem <Type> <Price> - 将指定名称的物品添加到商店求购。
• /shop buyitem <Type> <Item Amount> <Price> - 将指定名称和数量的物品添加到商店求购。
• /shop setpermission <Player> <Permission> <Value> - 为玩家设置权限（仅限商店管理员）。
• /shop permissions - 查看所有商店权限。
• /shop users - 列出所有拥有商店权限的玩家。
• /shop noInfo - 不接收交易信息通知。
• /shop info - 获取你所在商店的信息。
• /shop info <ID> - 获取指定 ID 商店的信息。
• /shop door add <ID> - 为商店添加门。
• /shop door remove - 从商店移除一扇门。
• /shop door open - 锁上自己商店的门。
• /shop door close - 打开自己商店的门锁。
• /shop rollback - 打开菜单查看商店中“被遗忘”的物品。
• /shop rollback %target% - 管理员命令，获取或检查目标玩家丢失的物品。
• /shop setAlias %alias% - 为你所在的商店设置一个别名。
• /shop setAliasCat %catAlias% - 为你所在商店的分类设置一个别名。
• /shop resign - 终止你当前的租赁合同。

酒店命令

• /hotels - 显示你拥有的所有酒店房间。
• /freehotels - 显示所有空闲酒店房间。
• /hotel help - 打开帮助手册。
• /hotel createCat <categoryID> <Price> <Time> - 创建一个酒店分类。
• /hotel deleteCat - 删除一个分类。
• /hotel listCat - 列出所有分类。
• /hotel list - 列出所有酒店房间。
• /hotel setarea <categoryID> - 将选定区域设置为指定分类的酒店房间。
• /hotel setpermission <Player> <Permission> <Value> - 为玩家设置权限（仅限酒店房间管理员）。
• /hotel permissions - 查看所有酒店房间权限。
• /hotel users - 列出所有拥有酒店房间权限的玩家。
• /hotel setprice <Price> - 更改租金价格（修改分类设置）。
• /hotel settime <Time> - 更改租赁时长（修改分类设置）。
• /hotel reset - 重置酒店房间，以便新玩家租用。
• /hotel delete - 完全删除酒店房间。
• /hotel updateBackup - 为当前酒店区域创建新备份。
• /hotel buy <shopId> - 租赁指定 ID 的酒店房间。
• /hotel info - 获取你所在酒店房间的信息。
• /hotel info <ID> - 获取指定 ID 酒店房间的信息。
• /hotel door add <ID> - 为酒店房间添加门。
• /hotel door remove - 从酒店房间移除一扇门。
• /hotel door open - 锁上自己酒店房间的门。
• /hotel door close - 打开自己酒店房间的门锁。
• /hotel setAlias %alias% - 为你所在的酒店房间设置一个别名。
• /hotel setAliasCat %catAlias% - 为你所在酒店房间的分类设置一个别名。
• /hotel resign - 终止你当前的租赁合同。

🔧权限

所有权限均可在配置文件中找到，你也可以修改权限名称。

• rentit.shop - 所有商店命令的权限
• rentit.hotel - 所有酒店命令的权限
• rentit.sign - 创建商店或酒店招牌的权限
• rentit.build - 在商店和酒店中绕过建造限制的权限

⭐PlaceholderAPI 变量

基于位置的变量

• %rentit_currentId% - 返回玩家所在酒店/商店的 ID。
• %rentit_currentType% - 返回玩家所在区域的类型（Hotel/Shop）。
• %currentOwner% - 返回玩家所在商店/酒店的所有者。

基于玩家的变量

（若将每位玩家的商店/酒店房间数量限制为一个，这些变量将更有意义）

• %rentit_player_hasshop% - 如果玩家拥有商店则返回 true。
• %rentit_player_hashotel% - 如果玩家拥有酒店房间则返回 true。
• %rentit_player_shop% - 返回玩家商店的 ID/别名。
• %rentit_player_hotel% - 返回玩家酒店房间的 ID/别名。
• %rentit_player_shop_category% - 玩家商店的分类。
• %rentit_player_hotel_category% - 玩家酒店房间的分类。
• %rentit_player_shop_expiration% - 商店合同的到期日期。
• %rentit_player_hotel_expiration% - 酒店合同的到期日期。
• %rentit_player_shop_price% - 商店价格。
• %rentit_player_hotel_price% - 酒店价格。
• %rentit_player_shop_duration% - 商店合同时长。
• %rentit_player_hotel_duration% - 酒店合同时长。
• %rentit_player_shop_size% - 商店库存大小。

✨安装与依赖

必需依赖

• Vault - 用于支持各种经济系统。
• WorldEdit - 用于区域计算。

软依赖

• Citizens - 用于玩家 NPC。你可以在配置中关闭此功能 (Options.useNPCs = false) 而不必安装。
• WorldGuard - 受支持。可以防止在受保护区域（如出生点）内建造时出错。

安装步骤

• 将所有 .jar 文件（worldedit.jar, vault.jar, citizens.jar*, rentit.jar）以及你的经济插件放入服务器的 /plugins/ 目录。
• 重启服务器。
• 插件将在 RentIt 文件夹中生成配置文件。你需要编辑配置文件并填入你的数据库连接信息。
• （可选）浏览配置条目，根据喜好自定义语言和设置。

*Citizens 为软依赖。

🔧使用教程

管理员：商店设置

• 创建一个商店分类。例如：/shop createCat 1 100 9 7D。这表示如果玩家想租用分类 ID 为 1 的商店，他需要每 7 天支付 100 美元，商店物品栏大小为 9。重要：日期单位字母需区分大小写。
• 使用 WorldEdit 选择一个方形区域（例如一个房间内的空间）。玩家将能在此区域内建造，请注意不要选中玩家不应破坏的方块。
• 运行命令 /shop setArea 1 将该区域与分类关联。你站立的位置将成为玩家的传送点。
• 设置 NPC 位置 (/shop setNPC)。NPC 是后续的商店交互对象。
• 为玩家创建一个招牌（需要 rentit.sign 权限）。格式：[Shop] <ShopID>。
• 管理员可以按住 Shift + 右键单击招牌来更改设置，这些设置将作用于整个分类。

管理员：酒店设置

• 创建一个酒店分类。例如：/hotel createCat 1 100 7D。这表示如果玩家想租用分类 ID 为 1 的酒店房间，他需要每 7 天支付 100 美元。
• 使用 WorldEdit 选择一个方形区域。
• 运行命令 /hotel setArea 1 将该区域与分类关联。你站立的位置将成为玩家的传送点。
• 为玩家创建一个招牌（需要 rentit.sign 权限）。格式：[Hotel] <HotelID>。
• 管理员可以按住 Shift + 右键单击招牌来更改设置，这些设置将作用于整个分类。

分类设置 (Config)

以下是为特定商店和酒店分类在配置文件中进行的设置：

• usePermission -> 购买此类商店/酒店是否需要特殊权限
• autoPaymentDefault -> 自动支付的默认状态
• autoPaymentDisabled -> 自动支付是否可被更改
• maxRentExtendAmount -> 玩家可延长租约的最大次数
• disableDoorCommand -> 是否禁用门命令
• ownerBypassLock -> 所有者或拥有权限的玩家是否可以打开上锁的门
• doorsClosedUntilBuy -> 在有人购买商店/酒店房间前，门是否应保持关闭？True 允许玩家查看，直到有人租用并执行 /shop door close
• doorsClosedAfterBuy -> 玩家购买商店或酒店房间后的默认状态
• allowUsersToMoveNPC -> 是否允许商店所有者使用 /shop setnpc 命令移动他们的 NPC
• reminderRentRunningOut -> 在租金到期前（若未启用自动支付）提醒所有者剩余时间

配置示例

categorySettings:
  ShopCategory:
    1:
      usePermission: false
      autoPaymentDefault: true
      # ... 其他设置
  HotelCategory:
    1:
      usePermission: false
      autoPaymentDefault: true
      # ... 其他设置

玩家：商店使用

• 要租用商店，玩家只需点击招牌并接受合同。
• 店主可以给朋友授予权限，例如 "build"（建造）、"sell"（出售）、"buy"（购买）、"fill"（填充）或使用 "admin" 授予所有权限（可通过 /shop permissions 查看列表）。授权命令：/shop setpermission <玩家名> <权限> <true/false>。
• 出售物品：使用 /shop sellitem <价格>。将以玩家手中物品的确切数量按给定价格出售。之后可以创建箱子放入更多物品，商店将优先出售存储箱中的物品。
• 购买物品：使用 /shop buyitem <价格> 购买手中的物品，或使用 /shop buyitem <材料> <数量> <价格> 购买其他物品。物品将被放入有空间的商店箱子中。
• 如果玩家不想接收交易信息，可以使用 /shop noinfo 对特定商店禁用通知。

玩家：酒店使用

• 要租用酒店房间，玩家只需点击招牌并接受合同。
• 店主可以给朋友授予 "build"（建造）权限或使用 "admin" 授予所有权限（可通过 /hotel permissions 查看列表）。授权命令：/hotel setpermission <玩家名> <权限> <true/false>。

权限说明

• build - 建造权限
• fill - 可与箱子交互，填充或取出物品
• sell - 使用 /shop sellitem 命令在商店出售物品
• buy - 使用 /shop buyitem 命令在商店购买物品
• door - 允许通过上锁的门并能够上锁/解锁门
• admin - 所有权限

时间格式

• Y – 年
• M – 月
• D – 天
• h – 小时
• m – 分钟

❓联系与支持

• 支持与文档：https://wiki.uc-gg.de/en/Support
• 如果你喜欢这个插件，请考虑为其评分。也欢迎捐赠支持开发者。

---

开发者注：目前由于时间原因，仅提供版本更新，暂无新功能添加，但插件并未被放弃。

💡RentIt

RentIt 是一个允许玩家租赁世界区域（领地）的插件。租赁期结束后，领地会自动过期并移除，无需手动管理。它非常适合服务器上的临时商店、活动场地或短期项目。

🎮功能

• 自动租赁管理：设置租赁时长，到期后领地自动移除。
• 灵活的租赁选项：支持按天、周、月设置租赁期。
• 租赁历史记录：记录谁租赁了哪个领地，便于查询。
• 到期通知：在租赁到期前通过游戏内消息或邮件通知玩家。
• 权限控制：通过权限节点精细控制插件功能的使用。
• 多世界支持：可在服务器的多个世界中配置和使用租赁功能。
• API 支持：为开发者提供 API，以便与其他插件集成。

🔧命令与权限

主要命令

• /rent create <名称> <天数> - 创建一个新的可租赁领地。
• /rent list - 列出所有可租赁的领地。
• /rent info <名称> - 查看特定领地的详细信息。
• /rent rent <名称> - 租赁指定的领地。
• /rent cancel <名称> - 取消您当前的租赁（如果允许）。
• /rent reload - 重载插件配置（需要管理员权限）。

权限节点

• rentit.use - 允许使用基本的租赁命令（如 /rent list, /rent info）。
• rentit.rent - 允许玩家租赁领地。
• rentit.create - 允许玩家创建可租赁的领地。
• rentit.cancel - 允许玩家取消自己的租赁。
• rentit.admin - 授予所有管理权限，包括 /rent reload。

✨安装与配置

安装步骤

• 确保服务器已安装 WorldGuard 和 WorldEdit，因为 RentIt 依赖它们来管理区域。
• 将下载的 RentIt.jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 根据需要编辑生成的配置文件 (plugins/RentIt/config.yml)。

基本配置

首次运行时，插件会生成默认配置文件。你可以调整以下关键设置：

• 租赁价格公式：基于领地面积和租赁天数计算价格。
• 默认租赁期限：设置玩家使用 /rent rent 时的默认租赁天数。
• 到期前提醒：配置在到期前多少天通知玩家。
• 世界黑名单：指定不允许租赁的世界。

❓常见问题

• 问：租赁到期后，领地里的建筑和物品会怎样？
• 答：租赁到期后，该区域会被完全释放。强烈建议在租赁到期前备份重要建筑和物品，因为它们可能会被重置或删除（取决于世界保护设置）。

• 问：可以续租吗？
• 答：可以。在租赁到期前，玩家可以对已租赁的领地再次使用 /rent rent 命令来续租。

• 问：插件与领地插件（如 Residence、GriefPrevention）冲突吗？
• 答：RentIt 专为与 WorldGuard 配合工作而设计。与其他领地插件同时使用可能导致意外行为，不建议这样做。

• 问：如何更改租赁价格？
• 答：编辑 config.yml 文件中的 price-formula 部分。公式可以使用变量如 {area}（面积）和 {days}（天数）。

⭐依赖

• 必需插件：
• WorldGuard
• WorldEdit
• 推荐 Minecraft 服务端版本：Paper/Spigot 1.16.5 及以上版本。
• 支持的经济插件：Vault（用于支付租金）。

🔧链接与支持

• 官方 Wiki（本页面）：https://wiki.uc-gg.de/en/RentIt
• 下载：请从官方来源或认可的插件平台获取。
• 支持：如需帮助，请查阅 Wiki 或在插件发布页面的评论区留言。