String Rituals
适用于 Paper 服务器的完全可配置的游戏内仪式与祭坛系统。构建可制作的祭坛,生成世界仪式掉落物,并通过图形用户界面(GUI)编辑所有内容——无需配置文件。
注意: 此为早期测试版本。需要 Paper(或其分支如 Purpur)。它不支持 Spigot 或 CraftBukkit。
功能
- 配方仪式(制作祭坛): 为任意配方放置一个祭坛。站在祭坛附近并持有所需材料,会出现旋转的结果物品,完成后掉落。支持普通祭坛和一次性祭坛(制作一次后移除)。任何玩家都可以在祭坛处进行制作——只有管理员 (
ritual.admin) 可以生成或放置祭坛。
- 世界仪式(“Rituals”): 悬浮、旋转的仪式物品,按需在世界中生成,并可选地发送全服广播(开始 + 坐标 + 完成)。
- 随机生成: 开启后,任何标记为“随机生成”的仪式将按照设定的间隔自动出现在世界边界内的某个位置,存活一段可配置的时长后消失。非常适合制造惊喜的世界事件。默认关闭。
- 完整的游戏内编辑器: 创建/编辑配方,设置结果、持续时间、视觉预设、重命名、通过拖放添加/移除材料、放置/移除祭坛,以及切换随机生成——全部在 GUI 中完成。
- 全局设置: 切换广播、坐标、声音、粒子、闪电、广播间隔、默认持续时间、单次制作广播以及随机生成。
- 11 种精心调校的视觉预设,具有大幅增强的粒子与音频效果(双旋转环、上升柱、轨道光点、地面冲击波,以及每个主题特有的标志性特效,如闪电打击、火焰喷射和龙息)。
- 自定义武器: 内置 Cataclysm、Eclipse、Widowmaker 和 Oathbreaker 物品,可用作仪式结果。
- 一切皆由数据驱动: 配方存储在
rituals: 下,世界仪式存储在 drop-rituals: 下。我不需要手动编辑配置文件。
安装
- 下载
StringRituals.jar。
- 将其放入服务器的
plugins/ 文件夹中。
- 重启服务器(或运行
/reload)。会自动创建一个包含示例仪式的 config.yml。
- 将自己设为 OP(或授予
ritual.admin 权限),然后运行 /ritual settings。
入门指南
1. 打开控制面板
- 运行
/ritual settings。
- 主菜单显示 9 个切换面板和两个列表按钮:Recipe Rituals(配方仪式)和 Rituals(世界仪式)。
2. 全局设置(主菜单)
- 点击绿色/红色面板以切换:Broadcast Coords(广播坐标)、Initial Broadcast(初始广播)、Completion Broadcast(完成广播)、Broadcast Crafts(广播制作)、Sounds(声音)、Particles(粒子)、Lightning(闪电)、Random Spawns(随机生成)、Random Broadcast(随机广播)。
- 点击纸张状面板以更改 Broadcast Interval(广播间隔)、Default Duration(默认持续时间)和 Random Interval(随机间隔)。
3. 创建制作仪式(祭坛)
- 主菜单 → Recipe Rituals → New Recipe(绿宝石块)。
- 在聊天中输入 ID(例如
fire_blade)——仅允许字母、数字和下划线。
- 在编辑器中:Set Result(设置结果)= 手持你想要制作的物品,然后点击它。Rename(重命名)= 输入显示名称。设置 Duration(持续时间)和 Preset(预设)。
- Ingredients(材料)→ Add Ingredient(添加材料)→ 将一件物品拖入任意槽位,然后点击 Save Ingredient(保存材料)(如有更多材料请重复此操作)。点击列表中的材料即可移除它。
- Place Altar Here(在此处放置祭坛)会在你的位置生成祭坛(或使用
/ritual place <id>)。开启 One-Shot Altar(一次性祭坛)选项可在制作一次后移除祭坛。
- 制作:站在祭坛附近并在背包中持有所需物品——仪式自动开始,出现旋转的结果物品,计时结束后物品掉落。(或者从任何地方使用
/ritual craft <id>。)
4. 创建世界仪式(掉落物)
- 主菜单 → Rituals → New Ritual(绿宝石块)。手持结果物品,然后在聊天中输入 ID。
- 编辑器:设置 Duration(持续时间)/ Preset(预设)/ Rename(重命名)。点击 Spawn Now(立即生成)在你的位置生成掉落物。
- 命令替代方案:
/ritual create <id> <preset> <seconds>(手持结果物品时),然后 /ritual spawn <id>。使用 /ritual list 列出,使用 /ritual remove <id> 移除。
随机生成
- 打开
/ritual settings → 启用 Random Spawns(随机生成),设置 Random Interval(随机间隔,即尝试生成的秒数间隔)和 Random Broadcast(随机广播)。
- 在任意仪式的编辑器中(配方或世界),开启 Random Spawn(随机生成)并设置其 Random Lifetime(随机生命周期,即随机生成的实例在消失前存活的时长)。
- 在每个间隔周期,插件会选择一个随机启用的且开启了 Random Spawn 的仪式,并将其生成在世界边界内的随机位置(地表)。配方仪式会生成一个临时祭坛;世界仪式会生成一个临时熔炉。两者在其生命周期结束后都会自动消失。
注意:主开关 Random Spawns(随机生成)默认为关闭状态,因此在你启用它之前不会有任何东西生成。
命令
| 命令 |
描述 |
/ritual settings |
打开 GUI 控制面板 |
/ritual list |
列出所有世界仪式 |
/ritual create <id> <preset> <seconds> |
注册一个世界仪式(需手持结果物品) |
/ritual spawn <id> [x y z world] |
在指定位置生成一个世界仪式 |
/ritual remove <id> |
移除一个世界仪式 |
/ritual place <recipe> [x y z world] |
放置一个制作祭坛 |
/ritual craft <recipe> |
在你所在位置启动制作(无需祭坛) |
/ritual give <cataclysm|eclipse|widowmaker|oathbreaker|all> [player] |
给予自定义武器 |
/ritual reload |
重新加载配置 |
/string |
用线填充你空的物品栏槽位 |
权限
| 权限 |
默认值 |
描述 |
ritual.admin |
op |
访问所有 /ritual 命令及编辑器 |
stringrituals.string |
true |
使用 /string |
配置
所有设置都位于 config.yml 的 ritual: 部分下,并且可以从 GUI 实时编辑。配方存储在 rituals: 下;世界仪式存储在 drop-rituals: 下。示例(默认随附):
ritual:
default-duration: 30
broadcast-interval: 10
initial-broadcast: true
broadcast-coords: true
completion-broadcast: true
broadcast-craft: false
sounds: true
particles: true
lightning: true
display-scale: 1.0
random-spawns: false
random-interval: 300
random-broadcast: true
rituals:
example_relic:
enabled: true
oneShot: false
duration: 30
preset: arcane
name: Example Relic
result: NETHERITE_SWORD
ingredients:
DIAMOND: 4
NETHERITE_INGOT: 1
drop-rituals:
example_world_drop:
enabled: true
duration: 45
preset: void
item: TOTEM_OF_UNDYING
视觉预设
preset 控制仪式的粒子/音频主题。我筛选出潜力最大的 11 种,并为每种大幅提升了视觉效果:
arcane · tempest · inferno · glacier · void · abyss · shriek · warp · bloodmoss · soul · dragon
兼容性
- 支持: Paper、Purpur(以及其他基于 Paper 的分叉版本)。
- 不支持: Spigot、CraftBukkit —— 该插件使用了 Paper 的 Adventure
Component API 和 org.joml 数学库,而这些加载器缺乏这些功能。
反馈
这是一个测试发布版本。发现了 bug 或有新想法?请在 Modrinth 项目页留下评论——这将直接决定我接下来修复和添加的内容。
String Rituals
A fully configurable, in-game ritual & altar system for Paper servers. Build craftable altars, spawn world ritual drops, and edit everything from a GUI - no config files required.
Note: This is an early test release. Requires Paper (or a Paper fork such as Purpur). It does not run on Spigot or CraftBukkit.
Features
- Recipe Rituals (crafting altars): place an altar for any recipe. Stand near it with the required ingredients and a spinning result item appears, then drops on completion. Supports normal and One-Shot altars (removed after one craft). Any player can craft at an altar - only admins (
ritual.admin) can spawn or place them.
- World Rituals ("Rituals"): floating, spinning ritual items that spawn in the world on demand, with optional server-wide broadcasts (start + coordinates + completion).
- Random Spawns: turn it on and any ritual flagged "Random Spawn" will automatically appear somewhere inside the world border on a set interval, live for a configurable lifetime, then despawn. Great for surprise world events. Off by default.
- Full in-game editor: create/edit recipes, set results, durations, visual presets, rename, add/remove ingredients via drag-and-drop, place/remove altars, and toggle random spawning - all from the GUI.
- Global settings: toggle broadcasts, coordinates, sounds, particles, lightning, broadcast interval, default duration, per-craft broadcasts, and random spawns.
- 11 hand-tuned visual presets with massively boosted particle & audio effects (twin rotating rings, rising pillars, orbiting motes, ground shockwaves, and per-theme signature flourishes like lightning strikes, flame jets, and dragon's breath).
- Custom weapons: built-in Cataclysm, Eclipse, Widowmaker, and Oathbreaker items for use as ritual results.
- Everything is data-driven: recipes live under
rituals:, world rituals under drop-rituals:. I don't need to edit config files by hand.
Installation
- Download
StringRituals.jar.
- Drop it into your server's
plugins/ folder.
- Restart (or run
/reload). A config.yml is created automatically with example rituals.
- OP yourself (or grant
ritual.admin) and run /ritual settings.
Getting Started
1. Open the control panel
- Run
/ritual settings.
- The main menu shows 9 toggle panes and two list buttons: Recipe Rituals and Rituals.
2. Global settings (main menu)
- Click any green/red pane to toggle: Broadcast Coords, Initial Broadcast, Completion Broadcast, Broadcast Crafts, Sounds, Particles, Lightning, Random Spawns, Random Broadcast.
- Click the paper panes to change Broadcast Interval, Default Duration, and Random Interval.
3. Create a Crafting Ritual (altar)
- Main menu → Recipe Rituals → New Recipe (emerald block).
- Type an ID in chat (e.g.
fire_blade) - letters, numbers and _ only.
- In the editor: Set Result = hold the item you want crafted, then click it. Rename = type a display name. Set Duration and Preset.
- Ingredients → Add Ingredient → drag one item into any slot, then click Save Ingredient (repeat for more). Click an ingredient in the list to remove it.
- Place Altar Here spawns the altar at your location (or
/ritual place <id>). Toggle One-Shot Altar ON to remove it after one craft.
- Craft: stand near the altar with the required items in your inventory - the ritual auto-starts, a spinning result item appears, and the item drops when the timer ends. (Or
/ritual craft <id> from anywhere.)
4. Create a World Ritual (drop)
- Main menu → Rituals → New Ritual (emerald block). Hold the result item, then type an ID in chat.
- Editor: set Duration / Preset / Rename. Click Spawn Now to drop it at your location.
- Command alternative:
/ritual create <id> <preset> <seconds> (while holding the result item), then /ritual spawn <id>. List with /ritual list, remove with /ritual remove <id>.
Random Spawns
- Open
/ritual settings → enable Random Spawns, set Random Interval (seconds between attempts) and Random Broadcast.
- In any ritual's editor (Recipe or World), toggle Random Spawn ON and set its Random Lifetime (how long a randomly spawned instance stays before despawning).
- On each interval the plugin picks a random enabled ritual with Random Spawn ON and drops it at a random spot inside the world border (on the surface). Recipe rituals spawn a temporary altar; world rituals spawn a temporary forge. Both auto-despawn after their lifetime.
Note: the master Random Spawns switch is OFF by default, so nothing spawns until you enable it.
Commands
| Command |
Description |
/ritual settings |
Open the GUI control panel |
/ritual list |
List all world rituals |
/ritual create <id> <preset> <seconds> |
Register a world ritual (hold the result item) |
/ritual spawn <id> [x y z world] |
Spawn a world ritual at a location |
/ritual remove <id> |
Remove a world ritual |
/ritual place <recipe> [x y z world] |
Place a crafting altar |
/ritual craft <recipe> |
Start a craft at your location (no altar) |
/ritual give <cataclysm|eclipse|widowmaker|oathbreaker|all> [player] |
Give a custom weapon |
/ritual reload |
Reload config |
/string |
Fill your empty inventory slots with string |
Permissions
| Permission |
Default |
Description |
ritual.admin |
op |
Access to all /ritual commands and the editor |
stringrituals.string |
true |
Use /string |
Configuration
All settings live in config.yml under the ritual: section and are editable live from the GUI. Recipes are stored under rituals:; world rituals under drop-rituals:. Example (ships by default):
ritual:
default-duration: 30
broadcast-interval: 10
initial-broadcast: true
broadcast-coords: true
completion-broadcast: true
broadcast-craft: false
sounds: true
particles: true
lightning: true
display-scale: 1.0
random-spawns: false
random-interval: 300
random-broadcast: true
rituals:
example_relic:
enabled: true
oneShot: false
duration: 30
preset: arcane
name: Example Relic
result: NETHERITE_SWORD
ingredients:
DIAMOND: 4
NETHERITE_INGOT: 1
drop-rituals:
example_world_drop:
enabled: true
duration: 45
preset: void
item: TOTEM_OF_UNDYING
Visual Presets
The preset controls the particle/audio theme of a ritual. I trimmed the list to the 11 with the most potential and gave each a massive visual boost:
arcane · tempest · inferno · glacier · void · abyss · shriek · warp · bloodmoss · soul · dragon
Compatibility
- Supported: Paper, Purpur (and other Paper-based forks).
- Not supported: Spigot, CraftBukkit - the plugin uses Paper's Adventure
Component API and org.joml math, which those loaders lack.
Feedback
This is a test release. Found a bug or have an idea? Leave a comment on the Modrinth project - it directly shapes what I fix and add next.
评论 0
登录后参与评分
还没有评论,来抢沙发吧