概述
NTicketPortal 是一款现代化的 Minecraft 门户管理插件(适用于 Paper/Folia),通过票据物品、时间窗口和完全可配置的传送设置来控制世界访问权限。
它旨在为工作人员提供简单易用的体验,同时为服务器所有者提供高度灵活性。你可以独立配置每个世界:门户可用性、票据要求、开放时间、开启/关闭时的控制台动作以及传送目的地。
NTicketPortal 非常适合生存、RPG、活动和经济类服务器,用于限制和管理如下界、末地或自定义维度等世界的访问。
功能
- 支持 Folia – 兼容现代的 Paper/Folia 环境。
- 世界票据系统 – 票据与特定世界绑定,使用后消耗。
- 自定义票据物品 – 支持设置材质、CustomModelData、显示名称、描述文本和发光效果。
- 每日时间表 – 为每周的每一天分别设置开放和关闭时间。
- 自动执行动作 – 当门户开启或关闭时运行控制台命令。
- 门户开关 – 快速启用或禁用某个世界的门户。
- 设置传送目的地 – 在游戏中配置目标传送位置。
- 多世界就绪 – 在
teleports 部分配置多个目的地。
- 可配置消息 – 直接在
config.yml 中自定义玩家/管理员消息。
安装与使用
- 将 NTicketPortal 放入服务器的
plugins 文件夹中。
- 启动服务器一次以生成配置文件。
- 打开并配置:
plugins/NTicketPortal/config.yml
- 在
teleports 中添加你的世界,并配置票据和时间规则。
- 为世界设置目的地出生点:
/nticketportal setspawn <world>
- 给玩家发放票据:
/nticketportal give <world> <amount> <player>
/nticketportal <player> <world>
命令
| 命令 |
描述 |
权限 |
/nticketportal give <world> <amount> <player> |
向指定玩家发放特定数量的某世界票据。 |
nticketportal.admin |
/nticketportal <player> <world> |
快捷命令,发放 1 张票据。 |
nticketportal.admin |
/nticketportal setspawn <world> |
设置某世界的目的地传送位置。 |
nticketportal.admin |
/nticketportal toggle <world> |
启用或禁用指定世界的门户。 |
nticketportal.admin |
工作原理
- 玩家尝试通过门户(下界/末地或插件/命令传送)进行移动。
- 插件验证该世界门户当前是否已启用且处于开放时间窗口内。
- 如果启用了票据模式,玩家必须在主手持有有效的、与该世界绑定的票据。
- 验证通过后,消耗一张票据并将玩家传送到配置的位置。
示例配置
config.yml
settings:
# 用于检查时间表的时间区域
time: 'Europe/Warsaw'
teleports:
world_the_end:
enabled: true
ticket:
enabled: true
item:
material: PAPER
modeldata: 10001
glow: true
name: '<green>End Pass'
lore:
- '<white>Allows access to world_the_end'
time:
enabled: true
actions:
open:
- say world_the_end portal is now OPEN!
close:
- say world_the_end portal is now CLOSED!
days:
MONDAY: { open: 8, close: 12 }
TUESDAY: { open: 8, close: 12 }
WEDNESDAY: { open: 8, close: 12 }
THURSDAY: { open: 8, close: 12 }
FRIDAY: { open: 8, close: 12 }
SATURDAY: { open: 8, close: 12 }
SUNDAY: { open: 8, close: 12 }
teleport:
enabled: true
location: null
支持与社区
需要帮助、发现了 Bug 或有功能建议?
加入下方的 Discord 服务器。我们会审阅反馈,并在未来的更新中考虑改进意见。
Overview
NTicketPortal is a modern Minecraft portal-management plugin (Paper/Folia) that controls world access using ticket items, time windows, and fully configurable teleport settings.
It is designed to be simple for staff and flexible for server owners. You can configure each world independently: portal availability, ticket requirements, opening hours, open/close console actions, and teleport destination.
NTicketPortal is a strong fit for survival, RPG, event, and economy servers where worlds such as Nether, End, or custom dimensions should be gated and controlled.
Features
- Folia Support – compatible with modern Paper/Folia environments.
- World Ticket System – tickets are bound to specific worlds and consumed on use.
- Custom Ticket Item – material, CustomModelData, display name, lore, and glow effect.
- Daily Time Schedule – separate open/close hours for each day of the week.
- Automatic Actions – run console commands when a portal opens or closes.
- Portal Toggle – quickly enable or disable a portal per world.
- Set Teleport Destination – configure target teleport locations in-game.
- Multi-world Ready – configure multiple destinations in the
teleports section.
- Configurable Messages – customize player/admin messages directly in
config.yml.
Installation & Usage
- Put NTicketPortal into your server
plugins folder.
- Start the server once to generate configuration files.
- Open and configure:
plugins/NTicketPortal/config.yml
- Add your worlds in
teleports and configure ticket/time rules.
- Set a destination spawn for a world:
/nticketportal setspawn <world>
- Give tickets to players:
/nticketportal give <world> <amount> <player>
/nticketportal <player> <world>
Commands
| Command |
Description |
Permission |
/nticketportal give <world> <amount> <player> |
Gives a specific amount of tickets for a selected world. |
nticketportal.admin |
/nticketportal <player> <world> |
Shortcut command that gives 1 ticket. |
nticketportal.admin |
/nticketportal setspawn <world> |
Sets the destination teleport location for a world. |
nticketportal.admin |
/nticketportal toggle <world> |
Enables or disables the portal for a selected world. |
nticketportal.admin |
How It Works
- A player attempts to travel through a portal (Nether/End or plugin/command teleport).
- The plugin validates whether that world portal is currently enabled and open by schedule.
- If ticket mode is enabled, the player must hold a valid world-bound ticket in the main hand.
- After validation, one ticket is consumed and the player is teleported to the configured location.
Example Configuration
config.yml
settings:
# Timezone used for schedule checks
time: 'Europe/Warsaw'
teleports:
world_the_end:
enabled: true
ticket:
enabled: true
item:
material: PAPER
modeldata: 10001
glow: true
name: '<green>End Pass'
lore:
- '<white>Allows access to world_the_end'
time:
enabled: true
actions:
open:
- say world_the_end portal is now OPEN!
close:
- say world_the_end portal is now CLOSED!
days:
MONDAY: { open: 8, close: 12 }
TUESDAY: { open: 8, close: 12 }
WEDNESDAY: { open: 8, close: 12 }
THURSDAY: { open: 8, close: 12 }
FRIDAY: { open: 8, close: 12 }
SATURDAY: { open: 8, close: 12 }
SUNDAY: { open: 8, close: 12 }
teleport:
enabled: true
location: null
Support & Community
Need help, found a bug, or want to suggest a feature?
Join the Discord server below. Feedback is reviewed and improvements are considered in future updates.
评论 0
登录后参与评分
还没有评论,来抢沙发吧