?️ SinceDungeon - 终极实例化地牢系统
SinceDungeon 是一款高性能、专业级的实例化地牢插件,专为现代 Minecraft 服务器(Paper 1.21+)原生打造。它赋予服务器管理员创建无缝、隔离冒险体验的能力,具备零信任安全机制、先进的 RPG 机制以及专业级优化。
与传统的地牢插件不同,SinceDungeon 专注于 稳定性、绝对的可定制性和极高的重玩价值。从动态 Roguelike 生成和 PAPI 条件命令执行,到完全交互式的游戏内 GUI 编辑器——SinceDungeon 是你构建史诗级怪物竞技场、错综复杂的故事线或竞技速通挑战的唯一框架。
✨ 主要功能
? 专业实例化与零信任安全
- 隔离异步世界: 每次地牢运行都是模板的新鲜克隆,在单独的线程上生成以确保 零 TPS 下降,完成后自动删除以保持服务器整洁。
- 深度克隆库存保护: 玩家进入时,其物品栏、盔甲和经验值会被安全地深度克隆到 RAM 中,随后被彻底清除。这保证没有人可以将 OP 物品 smuggle(走私)进地牢或将地牢专属任务物品带出。
- 漏洞预防: 原生阻止在地牢实例内传送(末影珍珠、紫颂果)、掉落物品和使用未授权命令。
⚡ 条件生命周期自动化(NEW)
无需杂乱的命令方块即可自动化地牢流程。在特定的生命周期触发器上自动执行控制台命令:
- 开始/结束/阶段完成: 随着玩家进度动态触发命令。
- 首次通关钩子: 定义仅在玩家第一次通关地牢时执行的命令(非常适合授予独家头衔、里程碑等级或独特的 Lore 物品)。
- PAPI 条件逻辑: 将命令格式化为
[condition] command_here。插件会在运行前评估 PlaceholderAPI 逻辑!示例:[%vault_eco_balance%;>=;500] eco give %player% 100
⏱️ 持久冷却时间与抽奖券(NEW)
- 按玩家、按地图冷却: 强制玩家在重新进入已清理地图之前等待可配置的时间,防止无限刷取。
- 交互式冷却券: 通过受 NBT 保护的抽奖物品来货币化你的服务器或奖励活跃玩家:
- 冷却重置券: 立即清除所有活动的地牢冷却时间。
- 时间跳过券: 将所有活动冷却时间减少特定时间段。
- PlaceholderAPI 追踪: 通过
%sincedungeon_cooldown_<map>%在记分板上实时显示剩余冷却时间。
?️ 革命性的游戏内编辑器
- 无需 YAML 麻烦: 通过美观的分页游戏内 GUI 完全创建阶段、生成波次、设置条件和配置奖励。
- 动态动作:
- 生成波次与神话 Boss: 支持原版或 MythicMobs 集成(支持与队伍规模缩放及混合随机怪物池!)。
- 控制区域: 在半径随时间缩小的过程中坚守特定区域,抵御干扰怪物。
- 解锁门与寻找钥匙: 给玩家一个追踪指南针,让他们 hunt down(搜寻)一把物理钥匙并解锁密封路径。
- 可破坏屏障: 当触发方块被摧毁时,魔法墙会异步崩塌。
- 战利品宝箱: 在运行中途以随机战利品奖励玩家。
? Roguelike 进程与高风险
- 随机化阶段: 在每次运行中洗牌地牢的中间阶段,使速通变得动态且不可预测。
- 百分比概率阶段: 创建稀有隐藏宝藏室或陷阱,这些内容仅在一定百分比的时间内生成。
- 行动时间限制: 通过强制玩家在严格的时间限制内完成目标,否则面临严重生命惩罚,增加高风险压力。
❤️ 生命值与不朽系统
- RPG 机制: 限制玩家进入地牢的次数。玩家在死亡或未能完成行动时间限时时会失去生命值。
- 被动再生: 生命值基于自定义或全局间隔随时间恢复,即使离线也会如此。
- 灵魂水晶: 分发特殊消耗品以恢复生命值,配备现代 1.21+ 物品组件、声音和粒子效果。
? 交互式排行榜与统计
- 全自动追踪: 原生追踪每个地牢的 最快通关时间、最多击杀数 和 最多通关次数。
- 游戏内 GUI (
/dungeon top): 玩家可以通过交互式分页 GUI 查看排名。管理员可以使用/sd top reset <map>清除特定地图的数据。 - 优化数据库: 由 HikariCP 驱动,支持 SQLite(本地)和 MySQL(网络)。
? 高级组队与动态命令
- 无冲突动态命令: 核心命令(
/party,/dungeon,/sincedungeon)不再是硬编码的!你可以在config.yml中完全重命名它们或分配自定义别名,以防止与 MMOCore 等插件发生冲突。 - 智能入场检查: 在进入队伍前自动验证每位成员的等级、金钱、生命值和距离。
- 跨服务器(实验性): 内置 Redis 和 BungeeCord/Velocity 支持,可将玩家从大厅服务器路由到专用的地牢节点服务器。
? 抽奖奖励系统
- 基于时间的层级: 用更多的战利品宝箱奖励更快的通关速度。
- 随机池: 支持原版物品、MMOItems 和控制台命令。
- 实例化拾取与自动领取: 每个玩家都有自己个人的奖励 GUI。如果他们断开连接或物品栏已满,奖励将自动领取并安全地掉落在他们脚边。
? 兼容性
- Paper/Purpur: 1.21 & 1.21.x(原生支持)/ 1.20.x(遗留 NMS 回退)
- MythicMobs: 打造史诗般的 Boss 战斗。
- MMOItems: 用自定义等级的装备奖励玩家。
- PlaceholderAPI: 自定义入场条件、生命周期命令逻辑以及状态追踪。
- Vault: 基于经济的入场费用。
- MySQL & Redis: 适用于大型网络和跨服务器设置。
? 有用链接
- ? 文档(Wiki): 浏览 Wiki
- ? 支持与社区: 加入我们的 Discord
- ? 展示: 在 YouTube 上观看
? 权限
SinceDungeon.admin- 访问编辑器、重载、旁观模式、重置冷却时间以及所有管理员命令。- 玩家命令(
/party、/dungeon join、/dungeon top、/dungeon lives)默认对所有用户启用。
?️ SinceDungeon - The Ultimate Instanced Dungeon System
SinceDungeon is a high-performance, premium-grade instanced dungeon plugin designed natively for modern Minecraft servers (Paper 1.21+). It empowers server owners to create seamless, isolated adventure experiences with zero-trust security, advanced RPG mechanics, and professional-tier optimization.
Unlike traditional dungeon plugins, SinceDungeon is built for stability, absolute customizability, and extreme replayability. From dynamic rogue-like generation and PAPI-conditional command executions to a fully interactive In-Game GUI Editor—SinceDungeon is the only framework you need to build epic mob arenas, intricate storylines, or competitive speedrun challenges.
✨ Key Features
? Professional Instancing & Zero-Trust Security
- Isolated Async Worlds: Every dungeon run is a fresh clone of your template, generated on a separate thread to ensure zero TPS drops, then automatically deleted after completion to keep your server clean.
- Deep-Clone Inventory Protection: Players' inventories, armor, and EXP are securely deep-cloned into RAM upon entry, then completely wiped. This guarantees no one can smuggle OP items into the dungeon or bring dungeon-exclusive quest items out.
- Exploit Prevention: Natively blocks teleportation (Ender Pearls, Chorus Fruit), item dropping, and unauthorized command usage while inside an instance.
⚡ Conditional Lifecycle Automation (NEW)
Automate your dungeon's flow without messy Command Blocks. Execute console commands automatically at specific lifecycle triggers:
- On-Start / On-Finish / On-Stage-Complete: Trigger commands dynamically as players progress.
- First-Time Clear Hook: Define commands that strictly execute only when a player beats a dungeon for the very first time (Perfect for granting exclusive Titles, Milestone Ranks, or unique Lore items).
- PAPI Conditional Logic: Format your commands as
[condition] command_here. The plugin evaluates PlaceholderAPI logic before running it! Example:[%vault_eco_balance%;>=;500] eco give %player% 100
⏱️ Persistent Cooldowns & Gacha Tickets (NEW)
- Per-Player, Per-Map Cooldowns: Prevent endless grinding by forcing players to wait a configurable amount of time before re-entering a cleared map.
- Interactive Cooldown Tickets: Monetize your server or reward active players with NBT-protected Gacha items:
- Cooldown Reset Ticket: Instantly wipes ALL active dungeon cooldowns.
- Time Skip Ticket: Reduces all active cooldowns by a specific amount of time.
- PlaceholderAPI Tracking: Display remaining cooldown times live on scoreboards via
%sincedungeon_cooldown_<map>%.
?️ Revolutionary In-Game Editor
- No YAML Hassle: Create stages, spawn waves, set conditions, and configure rewards entirely through a beautiful, paginated In-Game GUI.
- Dynamic Actions:
- Spawn Waves & Mythic Bosses: Vanilla or MythicMobs integration (Supports scaling with party size and mixed random mob pools!).
- Control The Zone: Hold a specific area as the radius shrinks over time, fighting off interference mobs.
- Unlock Door & Find Key: Give players a tracking compass to hunt down a physical key and unlock a sealed path.
- Breakable Barriers: Magical walls that crumble asynchronously when a trigger block is destroyed.
- Loot Chests: Reward players mid-run with randomized loot.
? Rogue-like Progression & High Stakes
- Randomize Stages: Shuffle the middle stages of your dungeon on every run to make speedrunning dynamic and unpredictable.
- Percent Chance Stages: Create rare, hidden treasure rooms or traps that only spawn a certain percentage of the time.
- Action Time Limits: Add high-stakes pressure by forcing players to complete objectives within a strict time limit, or face heavy life penalties.
❤️ Lives & Immortality System
- RPG Mechanics: Limit how many times players can enter a dungeon. Players lose lives when dying or failing action time-limits.
- Passive Regeneration: Lives regenerate over time based on custom or global intervals, even when offline.
- Soul Crystals: Distribute special consumable items that restore lives, complete with modern 1.21+ item components, sounds, and particles.
? Interactive Leaderboards & Statistics
- Fully Automated Tracking: Natively tracks Fastest Clears, Most Kills, and Most Clears for every single dungeon.
- In-Game GUI (
/dungeon top): Players can view rankings through an interactive, paginated GUI. Admins can wipe specific maps using/sd top reset <map>. - Optimized Database: Powered by HikariCP, supporting both SQLite (Local) and MySQL (Network).
? Advanced Party & Dynamic Commands
- Conflict-Free Dynamic Commands: Core commands (
/party,/dungeon,/sincedungeon) are no longer hardcoded! Fully rename them or assign custom aliases inconfig.ymlto prevent conflicts with plugins like MMOCore. - Smart Entry Checks: Automatically verifies every member for level, money, lives, and proximity before pulling the party in.
- Cross-Server (Experimental): Built-in Redis and BungeeCord/Velocity support to route players from a Lobby server to dedicated Dungeon Node servers.
? Gacha Reward System
- Time-Based Tiers: Reward faster completions with more loot chests.
- Randomized Pool: Support for Vanilla items, MMOItems, and Console Commands.
- Instanced Looting & Auto-Claim: Each player gets their own personal reward GUI. If they disconnect or their inventory is full, rewards are auto-claimed and dropped safely at their feet.
? Compatibility
- Paper/Purpur: 1.21 & 1.21.x (Native support) / 1.20.x (Legacy NMS fallback)
- MythicMobs: Create epic boss fights.
- MMOItems: Reward players with custom tier equipment.
- PlaceholderAPI: Custom entry conditions, lifecycle command logic, and stat tracking.
- Vault: Economy-based entry fees.
- MySQL & Redis: For large networks and cross-server setups.
? Useful Links
- ? Documentation (Wiki): Explore the Wiki
- ? Support & Community: Join our Discord
- ? Showcase: Watch on YouTube
? Permissions
SinceDungeon.admin- Access to the editor, reload, spectate, cooldown resets, and all admin commands.- Player commands (
/party,/dungeon join,/dungeon top,/dungeon lives) are enabled for everyone by default.
下载 SinceDungeon
下载 SinceDungeon
下载 SinceDungeon
下载 SinceDungeon
下载 SinceDungeon
下载 SinceDungeon
下载 SinceDungeon
下载 SinceDungeon
下载 SinceDungeon
下载 SinceDungeon
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
? SinceDungeon - 更新日志 v1.6.3(正式版本)
针对 1.6.3 版本的特性新增、系统重构及关键性能优化的全面汇总。
⚡ JIT 与内存性能优化
? JIT 循环抖动消除与内存泄漏修复
- JIT 循环抖动消除: 优化了
ControlZoneAction、ReachLocationAction和SmartBreakWallAction中重型粒子生成算法。移除了while/for循环内联的Location和Vector实例化操作,改用可复用的可变指针。这完全防止了在激烈 Boss 战期间出现巨大的垃圾回收 (GC) 峰值。 - MathCache 工具类: 添加了预计算的三角函数缓存 (
MathCache.java),以消除密集圆形粒子生成期间的 CPU 开销。将快速 360 度热循环中的所有Math.sin()和Math.cos()调用替换为新的MathCache数组,大幅稳定了服务器 TPS。 - 孤立世界内存泄漏修复: 在
WorldManager和DefaultInstanceProvider中实现了强大的递归重试机制。如果由于残留的区块票或实体导致地牢世界无法卸载,系统将强制清除所有实体并每 5 秒重试一次卸载,直到成功为止,从而彻底释放被困的 JVM 内存。 - 全面的缓存与内存清理:
- 修复了
DungeonGame.java中的离线内存泄漏问题:如果玩家在副本运行期间断开连接,玩家状态会无限期保留(savedStates缓存)。 - 通过静态跟踪活动的异步缓存任务,修复了 PlaceholderAPI 的任务泄漏,防止在执行
/papi reload时发生 CPU/内存泄漏。 - 通过准确追踪踢人倒计时
BukkitTask,修复了幽灵任务泄漏。现在可以在强制关闭时安全中止任务,防止Player对象内存泄漏。 - 向
LivesManager添加了cleanup()生命周期钩子,以便在服务器关闭/重载时安全终止异步数据库同步任务。 - 重构了多个核心和高级动作(
DefendCore、Escort、LootChest等)中的cleanup()方法,以显式清除持有已死实体引用的Set和Map集合。
- 修复了
? 线程处理与主线程卸载
- 消除 TPS 死亡循环: 从
DungeonListener中移除了完全未使用的超高频事件透传(如PlayerMoveEvent、ProjectileLaunchEvent等)。这永久解决了当 10+ 名玩家同时活跃运行副本时的 CPU 饥饿问题。 - I/O 事件缓存: 大幅提升了
DungeonListener的性能。高频事件不再每秒都查询 YAML 配置以获取世界前缀;该值现在缓存在内存中,并通过updateConfig()安全更新。 - UI 解析效率:
DungeonGame中的 Action Bar 滴答系统现在每秒仅编译一次MiniMessage组件,而不是为地图中的每个玩家重复解析它。 - 异常安全性加固: 使用
try-catch-finally块包裹DungeonGame中的stop()逻辑,以确保即使中途发生NullPointerException,也能绝对触发aggressivelyCleanupMemory()和世界卸载。 - 启动冻结修复: 将数据库、冷却时间、生命值和模板加载移至安全的异步启动流程。在允许玩家加入副本之前添加了启动就绪检查,防止插件启用期间服务器锁定。
? 原生 Folia 支持
- 实体线程并发: 通过
SchedulerCompat.runAtEntity(...)实现了符合 Folia 规范的实体线程并发。 - Folia
IllegalStateException修复: 通过将玩家状态恢复(生命值、物品栏、速度)强制推送到各自的EntityScheduler,解决了 Folia 服务器上的线程状态问题。 - FoliaDungeonValidator: 添加了专用的验证器,除非活动提供程序是共享世界兼容的(高级图纸模式),否则阻止在 Folia 上运行 Core 世界复制/模板世界副本。验证在模板加载、副本加入和编辑器保存时触发。
- 全息图现代化: 升级高级全息图更新以使用原生
TextDisplay实体,完全移除了过时的DecentHolograms依赖,并增强了 Folia 上基于区域的渲染。 - ⚠️ 配置警告: 此版本不支持同时运行
Folia+Schematic Mode(图纸模式)。
✨ 新功能与通用增强
? 通用自定义模型数据 (CMD) 支持
- 通用 CMD 集成: 副本 GUI、奖励宝箱、掉落池、排行榜和动态自定义物品中的所有物品现在原生支持通过
MATERIAL:AMOUNT:CMD配置格式使用自定义模型数据(例如DIAMOND_SWORD:1:123)。 - 智能材质解析: 你现在可以直接编写
PAPER:10606。插件会智能判断,因为 10,606 大于最大堆叠数量 64,所以你的意思是自定义模型数据,它将生成 1 个 CMD 为 10606 的纸。 - 组件列表保护: 简化了
items.yml的默认配置为custom-model-data: 1001(作为整数),确保自动更新器不再损坏组件列表。 - 提示: 如果在配置文件顶部添加
auto-update: false,可以防止系统自动更新该特定文件。
?️ 地牢管理与核心增强
- 多阶段首领追踪: 在
MYTHIC_WAVE动作中添加了target_to_kill参数。这为 MythicMobs 多阶段首领提供了完美支持。地牢目标能够准确追踪从初始 NPC/盔甲架到实际首领的转变,而不会过早自动完成。 - 控制台刷屏保护: 如果地图配置引发持续的结构错误,结构性任务(如
SmartBreakWallAction和通用 Tickables)现在将被强制取消并正确记录日志,从而防止无限循环的控制台刷屏。 - 访问控制与隐私重构:
- 普通成员不再可以查看或 Tab 补全
public: false的私密地牢。服务器管理员保留完整的 Tab 补全和可见性以用于测试目的。 - 添加了管理绕过规则:操作员可以执行
/dungeon join <map> <target>来强制将目标玩家移动到私密地图,绕过标准隐私层。
- 普通成员不再可以查看或 Tab 补全
- 高级 Multiverse-Inventories 兼容性: 将
MultiverseInventoriesHook拆分为单独的 V4 和 V5 实现,并使用安全的反射加载以防止在旧版服务器上出现NoClassDefFoundError。移除了旧的遗留权限,并实现了动态权限附加(mvinv.bypass.*),以干净地防止 MVI 在地牢传送时清除玩家物品栏。 - 并发安全: 替换了
DungeonGame内部共享的ArrayList用法,改用CopyOnWriteArrayList,彻底解决在高负载下出现的ConcurrentModificationException问题。
? 排行榜与 PlaceholderAPI (PAPI)
- 异步缓存层: 为 PAPI 查询引入了线程安全的内存缓存。数据每 5 分钟通过异步任务自动刷新,完全消除了由计分板刻度引起的数据库锁和主线程卡顿。
- 智能地图 ID 解析: 地图占位符自动识别地图字符串逻辑,原生允许在地图 ID 配置名称中使用下划线 (
_),而不会破坏排名跟踪解析。 - 新的管理员命令:
- 目标重置命令:
/sincedungeon top resetplayer <player> [map]允许管理员直接从数据库中删除特定玩家的指标,而无需清除整个地图的历史记录。 - 隐身绕过节点:添加了
SinceDungeon.top.ignore。拥有此权限的玩家/管理员完全绕过排行榜插入,防止员工账号占据榜首。
- 目标重置命令:
? 游戏玩法机制与命令
- 地牢消耗品限制: 服务器所有者现在可以通过
settings/items.yml中的allow-use-in-dungeon: false,严格禁止玩家在活动地牢实例内战斗时消耗实用道具(灵魂水晶、冷却重置票、时间跳过票)。 - 全面的生命值命令扩展: 添加了用于管理生命值的完整命令结构,支持
-s(静默)标志以抑制反馈消息:/sincedungeon lives <target> add/reduce/set <amount> [-s]/sincedungeon lives <target> addmax <amount> [-s]/sincedungeon lives <target> setregenamount <amount> [-s]/sincedungeon lives <target> setregeninterval <seconds> [-s]/sincedungeon lives <target> resetregen/check [-s]/sincedungeon givelifeitem <target> <amount> [-s]
- 精细的生命值扣除: 在各文件中添加了精确的生命值扣除钩子:
lives-deducted-on-leave: 0、lives-deducted-on-fail: 0和lives-deducted-on-clear: 0。 - 战斗区域封锁: 添加了逻辑,在地牢首领战期间自动封锁战斗区域,防止被击败的玩家重新加入并干扰阶段机制。
- 重力方块修复: 修复了受重力影响的方块(如沙子和砾石)在实例化地牢世界中无法下落的问题。
?️ 开发者 API
SinceDungeonAPI.java重载: 引入了一个新的 API 方法重载:joinDungeon(Player player, String id, boolean allowPrivate)。这允许第三方挂钩和外部插件在明确的后台验证下,安全地强制加入或将玩家程序化地转移到私密地牢。- 捆绑 JDBC 驱动程序: 在项目 jar 中原生捆绑了 SQLite 和 MySQL JDBC 驱动程序,以实现高度可靠、开箱即用的数据库初始化。
- 文档迁移: 将官方 wiki/文档仓库迁移到 GitHub Pages,位于
docs/目录下,并与自动化部署工作流集成。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧