? JobX - 终极城市建造职业系统
JobX 是一个高度可配置的职业与奖励系统,专为 Paper 和 Spigot 服务器设计(需要 Vault)。玩家通过执行日常操作如挖掘、击杀实体、钓鱼、合成、交易或探索来赚取金钱并获得经验值。该插件具备完整的等级系统、自动定期发放、每小时收入上限、全服排行榜、基于每个玩家的 YAML 存储,以及为玩家和管理员提供的直观游戏内 GUI。
✨ 主要功能
- 10 种默认职业:
HUNTER、MINER、WOODCUTTER、DIGGER、FARMER、EXPLORER、CRAFTER、TRADER、FISHER、BUILDER。
- 职业等级: 每次行动获得经验值,并支持完全自定义的升级经验曲线。更高等级需要显著更多的经验值。
- 定期发放: 收益会被打包并通过 Vault 按固定间隔自动发放(默认:每 1200 tick(60 秒))。
- 收入限制: 可选的小时/限时收益上限,并集成冷却时间显示。
- 统计数据: 清晰记录每位玩家及每个职业的每日、每周和每月统计数据。
- 全服排行榜: 针对每种职业的排行榜(基于等级 + 经验值),可直接在 GUI 中查看(最多 28 个槽位)。
- 智能监听器: 完整追踪并分配
BlockBreak(破坏方块)、BlockPlace(放置方块)、EntityKill(击杀实体)、Fishing(钓鱼)、Crafting(合成)、Trade(交易)和 PlayerMove(玩家移动)的经验值和金钱。
- 数据与安全: 持久化存储在
data/users/<UUID>.yml 中。提供安全的 Plugman 重载通知和无错误重载处理。
?️ 游戏内 GUI 与命令
? 玩家使用 (/job 或 /jobx)
打开一个视觉吸引人的界面,显示所有活跃职业:
- 个人等级和经验状态,包含可视化进度条。
- 当前每项操作的收益(公式:
baseIncome + (level * levelUpMultiplier))。
- 头部槽位显示当前每小时限制状态(
earned / max / reset)。
- 直接访问职业排行榜。
? 管理员使用 (/jobadmin 或 /jobxadmin)
允许直接在游戏中的 Anvil-UI 文本输入框内编辑几乎所有插件值:
- 开启/关闭职业,更改
DisplayName(显示名称),并替换 GUI 图标(Material)。
- 调整
baseIncome(基础收入)和 levelUpMultiplier(升级乘数)的值。
- 设置特定方块和实体的经验值。
- 配置职业收入限制并手动重置单个玩家的限制。
? 命令与权限
/job 或 /jobx — 打开玩家职业 GUI。(无需权限)
/jobadmin 或 /jobxadmin — 打开管理员 GUI。(权限:jobcfg.admin)
/jobadmin resetlimit <player> — 重置特定玩家的小时收入限制。(权限:jobcfg.admin.resetlimit)
/jobadmin reload — 安全地重新加载所有配置文件。(权限:jobcfg.admin.reloadPlugin)
? 安装与依赖
前置条件:
- 服务器: Paper 或 Spigot(强烈推荐使用 Paper)
- 经济系统: Vault
安装步骤:
- 下载
JobX.jar 文件。
- 将文件放入服务器的
plugins 文件夹中。
- 启动服务器以生成默认配置文件。
- 根据需要自定义
config.yml,并通过 /jobadmin reload 重新加载。
⚙️ 配置片段(示例)
prefix: "§b§lJobX §7» "
JobLimitEnabled: true
JobLimit: 500.0
JobLimitCooldown: 3600
TopListSize: 10
Jobs:
MINER:
Enabled: true
DisplayName: "Mining"
Material: "DIAMOND_PICKAXE"
baseIncome: 5.0
levelUpMultiplier: 1.5
blocks:
MINER:
DIAMOND_ORE:
XP: 20.0
⚡ 特殊福利与增益
JobX 内置了高级游戏玩法功能,可通过 GUI 或权限进行管理:
- 增益效果 (Boosters): 临时全局或个人倍增器,以加速你的游戏进程(例如,30 分钟内激活 2 倍金钱和经验值),或者像飞行 (Fly) 和 haste (急迫) 这样的增益。
- 职业奖励: 自定义物品包,玩家每达到 5 个职业等级即可领取一次。
❓ 常见问题解答 (FAQ)
Q: 是否必须使用 Vault?
A: 是的。如果没有 Vault 和运行的经济提供商,系统无法向玩家分发现金奖励。
Q: 我可以完全禁用特定职业吗?
A: 可以,你可以在 config.yml 中将 Enabled 设置为 false,或通过 /jobadmin GUI 即时完成。
Q: 如果玩家达到金钱上限,还会获得经验值吗?
A: 会!一旦玩家达到每小时金钱上限,现金收益将冻结,但他们仍会继续正常获取职业经验值。
?️ 支持与联系
如果遇到任何错误或想建议新功能,请随时联系我们!报告问题时,请务必附上您的服务器日志以及受影响的玩家文件 plugins/JobX/users/<UUID>.yml。
? 鸣谢与灵感
本插件深受流行德国城市建造服务器 OPSUCHT.net 上功能的启发。
? JobX - The Ultimate Citybuild Job System
JobX is a highly configurable job and reward system designed for Paper and Spigot servers (Vault required). Players earn money and gain XP by performing everyday actions such as mining, killing entities, fishing, crafting, trading, or exploring. The plugin features a complete leveling system, automated periodic payouts, hourly income limits, server-wide top lists, per-player YAML storage, and intuitive in-game GUIs for both players and admins.
✨ Main Features
- 10 Default Jobs:
HUNTER, MINER, WOODCUTTER, DIGGER, FARMER, EXPLORER, CRAFTER, TRADER, FISHER, BUILDER.
- Job Leveling: Earn XP per action with a fully customizable level-up XP curve. Higher levels require significantly more XP.
- Periodic Payouts: Earnings are bundled and automatically paid out via Vault at fixed intervals (Default: every 1200 ticks (60 seconds)).
- Income Limits: Optional hourly/timed earnings limits with an integrated cooldown display.
- Statistics: Clear daily, weekly, and monthly statistics tracked per player and job.
- Server-Wide Leaderboards: Top lists for every single job (based on Level + XP), viewable directly inside the GUI (up to 28 slots).
- Smart Listeners: Full tracking and XP/money allocation for
BlockBreak, BlockPlace, EntityKill, Fishing, Crafting, Trade, and PlayerMove.
- Data & Security: Persistent storage in
data/users/<UUID>.yml. Safe Plugman reload notices and error-free reload handling.
?️ In-Game GUIs & Commands
? For Players (/job or /jobx)
Opens a visually appealing interface displaying all active jobs:
- Personal level & XP status including visual progress bars.
- Current earnings per action (Formula:
baseIncome + (level * levelUpMultiplier)).
- Head slot showing the current hourly limit status (
earned / max / reset).
- Direct access to job leaderboards.
? For Admins (/jobadmin or /jobxadmin)
Allows editing almost all plugin values directly inside the game (utilizing Anvil-UIs for text inputs):
- Toggle jobs on/off, change the
DisplayName, and swap GUI icons (Material).
- Adjust the
baseIncome and levelUpMultiplier values.
- Set specific block and entity XP values.
- Configure job earnings limits and manually reset individual player limits.
? Commands & Permissions
/job or /jobx — Opens the player job GUI. (No permission required)
/jobadmin or /jobxadmin — Opens the admin GUI. (Permission: jobcfg.admin)
/jobadmin resetlimit <player> — Resets the hourly income limit for a specific player. (Permission: jobcfg.admin.resetlimit)
/jobadmin reload — Safely reloads all configuration files. (Permission: jobcfg.admin.reloadPlugin)
? Installation & Dependencies
Prerequisites:
- Server: Paper or Spigot (Paper heavily recommended)
- Economy: Vault
Installation Steps:
- Download the
JobX.jar file.
- Place the file inside your server's
plugins folder.
- Start the server to generate the default configuration files.
- Customize the
config.yml to your liking and reload it via /jobadmin reload.
⚙️ Configuration Snippet (Example)
prefix: "§b§lJobX §7» "
JobLimitEnabled: true
JobLimit: 500.0
JobLimitCooldown: 3600
TopListSize: 10
Jobs:
MINER:
Enabled: true
DisplayName: "Mining"
Material: "DIAMOND_PICKAXE"
baseIncome: 5.0
levelUpMultiplier: 1.5
blocks:
MINER:
DIAMOND_ORE:
XP: 20.0
⚡ Special Perks & Boosters
JobX comes packed with advanced gameplay features that can be managed via GUI or permissions:
- Boosters: Temporary global or personal multipliers to accelerate your gameplay (e.g., active 2x Money & XP for 30 minutes) Or Booster like Fly and Haste
- Job Rewards: Custom item packages that players can claim every 5 job levels they achieve.
❓ FAQ (Frequently Asked Questions)
Q: Is Vault strictly required?
A: Yes. Without Vault and a running economy provider, the system cannot distribute cash rewards to players.
Q: Can I disable specific jobs entirely?
A: Yes, you can do this either by setting Enabled: false in the config.yml or instantly via the /jobadmin GUI.
Q: Are XP still awarded if a player hits their money limit?
A: Yes! Once a player reaches their hourly money cap, cash earnings freeze, but they continue to gather job XP normally.
?️ Support & Contact
If you encounter any bugs or want to suggest new features, feel free to reach out! Please always include your server logs and the affected player file from plugins/JobX/users/<UUID>.yml when reporting issues.
? Credits & Inspiration
This plugin was heavily inspired by the features found on the popular German Citybuild server OPSUCHT.net.
评论 0
登录后参与评分
还没有评论,来抢沙发吧