EcoSTG
轻量级 Paper / Purpur 插件:经济系统、拍卖行、职业以及基于 Dialog API 的 ESC 主菜单。
当前版本: 1.5.22
适用于 Paper 1.21.11、26.1、26.1.2、26.2 和 26.3 ——请选择与你的服务器匹配的 jar 文件。
| 服务器 |
Java |
| Paper/Purpur 1.21.11 |
21+ |
| Paper 26.1 |
25+ |
| Paper 26.1.2 |
25+ |
| Paper 26.2 |
25+ |
| Paper 26.3 |
25+ |
更新日志:releases/。
依赖要求
- 必须使用上表中对应的 Paper(或 Purpur)版本——请勿跨行混用不同的 jar 文件
- 无需安装 Vault 或其他经济类插件——EcoSTG 自带基于 SQLite 的经济系统
功能特性
经济系统
-
初始资金:500 美元(可配置)
-
/shop /ah /auction — 拍卖行;/ah <搜索> 用于筛选商品列表(例如 /ah dirt)
-
/sell — 按 worth.yml 中的价格即时结算(潜影盒包含其内部物品);物品也会上架至拍卖行
-
/bal /balance /money — 显示你的余额(若对方允许,也可查看其他玩家的余额)
-
/moneytop — richest 玩家排行榜前 10 名
-
/ecoset <玩家> <数量> / /ecogive <玩家> <数量> — OP
-
/ecostg toggle <玩家> <on|off> — 为某玩家禁用经济系统(OP)
职业
/job — 选择一项职业
/jobsell — **在拍卖行(AH)出售所需的职业物品,附带徽章“由工人提供”**及折扣 %(所有人可见)
/jobinfo — 显示在快捷栏上方的职业状态信息(距离交货截止的天数)
- 错过游戏内日期截止期限 → 被解雇 + 现实时间冷却
/jobcancel /activejobs /job-timer-reset — 仅限 OP
家园
通过枢纽或 /home / /sethome / /delhome 设置命名家园。默认上限:3 个(配置项 homes.max)。OP 玩家无数量限制。
- 列表以对话框形式打开(而非箱子界面)。每个家园按钮均使用该家园的颜色。
- 针对每个家园:支持传送、更改颜色、重命名、删除
- 更改颜色预设选项包括:青色、白色、红色、橙色、黄色、绿色、蓝色、紫色、粉色、灰色
- 也可输入自定义 HEX 颜色值(格式为
#RRGGBB,例如 #55FFFF)
- 默认颜色:青色(
#55FFFF)
- 名称可包含空格(长度限制为 1–32 个字符:允许使用字母、数字、空格、下划线
_ 和连字符 -)
现有家园数据在更新后予以保留。旧版物品图标数值将回退至默认颜色。
ESC / 中心菜单
点击暂停屏幕按钮(默认标签为 EcoSTG)可直接打开中心菜单。通过 /menu(或 /ecostgmenu)也可进入相同菜单。
中心菜单功能包括:家园、拍卖行、出售、传送、排行榜、RTP、好友、支付、统计、末影箱、坐/躺(若安装了 GSit)、游戏模式(仅限 OP),以及最后的 设置。
每个中心菜单功能都对应一个聊天命令。
| 按钮 |
功能说明 |
| 家园 |
带颜色的命名家园;支持传送、颜色设置、重命名、删除(/home, /sethome, /delhome) |
| 拍卖行 / 出售 |
拍卖行(/shop);即时出售(/sell) |
| 传送 |
TPA / TPAHere(/tpa, /tpahere)。除非隐私设置允许直接传送,否则目标玩家必须接受请求 |
| 排行榜 |
金钱、游戏时长、击杀数、死亡数、方块数、生物击杀数(/leaderboard) |
| RTP |
在当前世界内,靠近你且在世界边界内的随机安全位置(/rtp,有冷却时间) |
| 好友 |
跟随某人;当双方互相跟随时成为好友(/friend)。支持筛选、搜索和查看玩家资料 |
| 支付 |
向在线玩家转账(/pay) |
| 统计 |
玩家统计数据预览;尊重隐私设置(/stats) |
| 末影箱 |
从任何位置打开你的末影箱(/enderchest, /ec) |
| 坐/躺 |
仅当安装了 GSit 时才显示 |
| 游戏模式 |
仅限 OP:生存 / 创造 / 冒险 / 旁观者 |
| 设置 |
循环切换隐私/聊天/通知、个人简介、视觉效果(/settings)——始终位于最后 |
/ecostg mainletters change <name> —— 仅限 OP。实时菜单会立即更新;ESC 按钮的标签需要重启服务器才能生效。
战斗
攻击其他玩家或受到任何伤害时,快捷栏上方会出现战斗计时器:Combat: <secs>s(秒数为蓝色)。计时器运行期间,家园 / TPA / TPAHere / RTP 将被禁用。再次受到伤害或造成伤害将重置计时器。
OP 永远不会被标记战斗状态。如果 OP 与非 OP 战斗,只有非 OP 会获得计时器。
好友
关注是单向的。只有当双方互相关注时,你们才会成为好友。
/friend add <player> — 关注
/friend remove <player> — 取消关注(若曾是好友则结束好友关系)
/friend list — 查看好友、正在关注的对象以及关注你的人
- 好友菜单:筛选、搜索、玩家按钮、+ 关注,以及个人资料(查看统计、支付、传送、取消关注)
聊天过滤、击杀/死亡通知以及设置为 Friends 的即时 TPA 均基于双向互粉关系。
日志记录
重要操作会以 [ACTION] 的形式在服务器控制台中记录。
命令
| 指令 |
适用对象 |
描述 |
/menu (/ecostgmenu) |
所有人 |
打开主菜单 |
/ecostg /ecostg help |
所有人 |
游戏内帮助 |
/tpa [player] /tpahere [player] (/tphere) |
所有人 |
传送请求 |
/tpaccept (/tpyes) /tpdeny (/tpno) |
所有人 |
接受 / 拒绝传送请求 |
/rtp |
所有人 |
随机传送(有冷却时间) |
/home [name] (/homes) /sethome [name] /delhome <name> |
所有人 |
家园设置 |
/stats [player] |
所有人 |
统计信息(尊重隐私) |
/friend add|remove|list [player] (/friends) |
所有人 |
关注;双方互关则为好友 |
/leaderboard [money|playtime|kills|deaths|placed|broken|mobs] (/lb) |
所有人 |
排行榜 |
/settings |
所有人 |
设置菜单 |
/enderchest (/ec, /ender) |
所有人 |
打开你的末影箱 |
/pay [player] [amount] |
所有人 |
付款(若省略参数则弹出 GUI) |
/bal [player] (/balance, /money) |
所有人 |
余额查询 |
/shop (/ah, /auction) [search] /moneytop |
所有人 |
拍卖行(可选搜索) |
/sell |
所有人 |
在拍卖行按 worth.yml 中的价格上架物品 |
/job /jobsell /jobinfo |
所有人 |
职业系统 |
/ecoset /ecogive /ecostg toggle |
OP(管理员) |
经济管理 |
/jobcancel /activejobs /job-timer-reset |
OP(管理员) |
职业管理 |
/ecostg mainletters change <name> |
OP(管理员) |
修改 ESC 界面 / 主标题文字 |
Install
- 将
builds/<your-paper-version>/EcoSTG-1.5.22.jar 复制到 plugins/ 目录
- 启动一次服务器以生成
config.yml、worth.yml、jobs.yml 和 ecostg.db
- 编辑配置文件,然后重启(对于 Paper/Purpur 插件,建议重启而非使用
/reload)
配置亮点
starting-balance: 500.0
currency-name: Dollars
currency-symbol: "$"
menu:
main-letters: "EcoSTG"
homes:
max: 3
rtp:
cooldown-seconds: 30
max-radius: 1500
min-radius: 32
max-attempts: 80
combat:
duration-seconds: 15
auction:
sale-tax-percent: 5.0
jobs:
deadline-ingame-days: 4
fire-cooldown-real-days: 30
ah-buyer-discount-percent: 8.0
worker-listing-discount-percent: 5.0
worth.yml — 所有物品的即时出售价格(启动时自动填充;您的修改会被保留)
jobs.yml — 职业定义及配送物品
现有的 config.yml 文件会保留其当前值;新增的配置键将使用上述默认值。
注意事项
- 基于 Paper 插件(
paper-plugin.yml + bootstrap)构建;兼容 Paper 和 Purpur。命令在代码中注册,而非通过 YAML 文件。
- Server Links 条目仅为美化链接(vanity URLs);实际菜单通过 ESC 键 或
/menu 命令打开。
- 修改
main-letters 会立即更新主菜单界面;ESC 暂停按钮的标签名称需重启后生效。
- RTP(随机传送)异步加载区块,并在玩家周围搜索目标点(有半径上限),而非整个默认世界边界。
- 金钱 Nametag(设置 → 视觉)仅在游戏中的玩家头顶显示。不会出现在聊天、TAB 列表或控制台中。
- 家园使用对话框式菜单。颜色数据存储在 SQLite 中;升级不会删除已有的家园。
许可证
MIT — 详见 LICENSE。
EcoSTG
Lightweight Paper / Purpur plugin: economy, auction house, jobs, and an ESC hub menu (Dialog API).
Current version: 1.5.22
Built for Paper 1.21.11, 26.1, 26.1.2, 26.2, and 26.3 — pick the jar that matches your server.
| Server |
Java |
| Paper/Purpur 1.21.11 |
21+ |
| Paper 26.1 |
25+ |
| Paper 26.1.2 |
25+ |
| Paper 26.2 |
25+ |
| Paper 26.3 |
25+ |
Release notes: releases/.
Requirements
- Matching Paper (or Purpur) line from the table above — do not mix jars across lines
- No Vault or other economy plugins — EcoSTG uses its own SQLite economy
Features
Economy
- Starting balance: 500 Dollars (configurable)
/shop /ah /auction — auction house; /ah <search> filters listings (e.g. /ah dirt)
/sell — instant pay at worth.yml prices (shulkers include contents); items also list on AH
/bal /balance /money — show your balance (or another player's, if they allow it)
/moneytop — top 10 richest players
/ecoset <player> <amount> / /ecogive <player> <amount> — OP
/ecostg toggle <player> <on|off> — disable economy for a player (OP)
Jobs
/job — choose one job
/jobsell — sell required job items on the AH with badge By a worker + discount % (visible to everyone)
/jobinfo — job status above the hotbar (days until delivery due)
- Miss the in-game-day deadline → fired + real-day cooldown
/jobcancel /activejobs /job-timer-reset — OP
Homes
Named homes via the hub or /home / /sethome / /delhome. Default max: 3 (homes.max). Operators have no limit.
- List opens as a dialog (not a chest). Each home button uses that home's color.
- Per home: Teleport, Change Color, Rename, Delete
- Change Color presets: Aqua, White, Red, Orange, Yellow, Green, Blue, Purple, Pink, Gray
- Or enter a custom HEX color (
#RRGGBB, e.g. #55FFFF)
- Default color: Aqua (
#55FFFF)
- Names can include spaces (1–32 characters: letters, numbers, spaces,
_, -)
Existing homes are kept across updates. Old item-icon values fall back to the default color.
ESC / hub menu
Tapping the pause-screen button (default label EcoSTG) opens the hub directly. Same menu via /menu (/ecostgmenu).
Hub: Homes, Auction, Sell, Teleport, Leaderboards, RTP, Friends, Pay, Stats, Ender Chest, Sit/lay (if GSit), Gamemode (OP), Settings (last).
Every hub feature also has a chat command.
| Button |
What it does |
| Homes |
Colored named homes; teleport, color, rename, delete (/home, /sethome, /delhome) |
| Auction / Sell |
Auction house (/shop); instant sell (/sell) |
| Teleport |
TPA / TPAHere (/tpa, /tpahere). Target must accept unless privacy allows instant |
| Leaderboards |
Money, playtime, kills, deaths, blocks, mobs (/leaderboard) |
| RTP |
Random safe spot in the current world, near you, inside the world border (/rtp, cooldown) |
| Friends |
Follow someone; friends when both follow (/friend). Filter, search, and open a player profile |
| Pay |
Pay online players (/pay) |
| Stats |
Player stats preview; respects privacy (/stats) |
| Ender Chest |
Open your ender chest from anywhere (/enderchest, /ec) |
| Sit/lay |
Shown only if GSit is installed |
| Gamemode |
OP only: Survival / Creative / Adventure / Spectator |
| Settings |
Tap-cycle privacy/chat/notifications, bio, visuals (/settings) — always last |
/ecostg mainletters change <name> — OP. Live menus update immediately; the ESC button label needs a server restart.
Combat
Hitting another player, or taking any damage, starts a combat timer above the hotbar: Combat: <secs>s (seconds in blue). While it is running, home / TPA / TPAHere / RTP are blocked. Taking or dealing damage again resets the timer.
Operators are never tagged. If an OP fights a non-OP, only the non-OP gets the timer.
Friends
Following is one-way. You become friends only when both players follow each other.
/friend add <player> — follow
/friend remove <player> — unfollow (ends friendship if you were friends)
/friend list — friends, following, and followers
- Friends menu: Filter, Search, player buttons, + Follow, and a profile (View Stats, Pay, Teleport, Unfollow)
Chat filter, kill/death notifications, and instant TPA set to Friends use mutual follows.
Logging
Important actions are logged as [ACTION] in the server console.
Commands
| Command |
Who |
Description |
/menu (/ecostgmenu) |
Everyone |
Open hub |
/ecostg /ecostg help |
Everyone |
In-game help |
/tpa [player] /tpahere [player] (/tphere) |
Everyone |
Teleport requests |
/tpaccept (/tpyes) /tpdeny (/tpno) |
Everyone |
Accept / deny TPA |
/rtp |
Everyone |
Random teleport (cooldown) |
/home [name] (/homes) /sethome [name] /delhome <name> |
Everyone |
Homes |
/stats [player] |
Everyone |
Stats (respects privacy) |
/friend add|remove|list [player] (/friends) |
Everyone |
Follow; friends when both follow |
/leaderboard [money|playtime|kills|deaths|placed|broken|mobs] (/lb) |
Everyone |
Leaderboards |
/settings |
Everyone |
Settings menu |
/enderchest (/ec, /ender) |
Everyone |
Open your ender chest |
/pay [player] [amount] |
Everyone |
Pay (GUI if you omit args) |
/bal [player] (/balance, /money) |
Everyone |
Balance |
/shop (/ah, /auction) [search] /moneytop |
Everyone |
Auction house (optional search) |
/sell |
Everyone |
List items on AH at worth.yml prices |
/job /jobsell /jobinfo |
Everyone |
Jobs |
/ecoset /ecogive /ecostg toggle |
OP |
Economy admin |
/jobcancel /activejobs /job-timer-reset |
OP |
Jobs admin |
/ecostg mainletters change <name> |
OP |
ESC / hub title |
Install
- Copy
builds/<your-paper-version>/EcoSTG-1.5.22.jar into plugins/
- Start once to generate
config.yml, worth.yml, jobs.yml, and ecostg.db
- Edit configs, then restart (prefer restart over
/reload for Paper/Purpur plugins)
Config highlights
starting-balance: 500.0
currency-name: Dollars
currency-symbol: "$"
menu:
main-letters: "EcoSTG"
homes:
max: 3
rtp:
cooldown-seconds: 30
max-radius: 1500
min-radius: 32
max-attempts: 80
combat:
duration-seconds: 15
auction:
sale-tax-percent: 5.0
jobs:
deadline-ingame-days: 4
fire-cooldown-real-days: 30
ah-buyer-discount-percent: 8.0
worker-listing-discount-percent: 5.0
worth.yml — instant-sell prices for every item (auto-filled on startup; your edits are kept)
jobs.yml — job definitions and delivery items
Existing config.yml files keep their current values; new keys use the defaults above.
Notes
- Built as a Paper plugin (
paper-plugin.yml + bootstrap); runs on Paper and Purpur. Commands are registered in code, not via YAML.
- Server Links entries are vanity URLs only; the real menu is the ESC button or
/menu.
- Changing
main-letters updates live menus immediately; the ESC pause button label updates after restart.
- RTP loads chunks asynchronously and searches around the player (capped radius), not the entire default world border.
- Money nametag (Settings → Visuals) shows only under the player's head in the world. It does not appear in chat, tab, or the console.
- Homes use dialog menus. Colors are stored in SQLite; upgrading does not delete homes.
License
MIT — see LICENSE.
评论 0
登录后参与评分
还没有评论,来抢沙发吧