⌂ SetHomePlugin
SetHomePlugin 是一款简洁且功能丰富的 Spigot/Paper 服务器家园管理插件。玩家可以在任意位置设置命名的家园,并通过倒计时、粒子效果和音效传送回这些地点。管理员可以通过 LuckPerms 或权限节点控制每个等级的家园数量上限——无需手动配置。精美的分页 GUI 配合删除确认机制,让每位玩家都能直观地管理自己的家园。
⌨️ 命令
| 命令 |
别名 |
权限 |
描述 |
默认值 |
/sethome <name> |
/sh |
sethome.use |
在当前所在位置保存一个家园 |
✅ 所有玩家 |
/home <name> |
/h |
sethome.use |
传送到已保存的家园 |
✅ 所有玩家 |
/delhome <name> |
/deletehome, /removehome |
sethome.use |
删除一个已保存的家园 |
✅ 所有玩家 |
/homes |
/homelist, /listhomes |
sethome.use |
打开分页家园 GUI |
✅ 所有玩家 |
/sethomereload |
/shreload |
sethome.admin |
重载插件配置 |
? OP |
? 权限
| 权限 |
默认值 |
描述 |
sethome.use |
所有玩家 |
使用 /sethome, /home, /delhome, /homes |
sethome.admin |
OP |
重载配置,无视家园数量限制 |
sethome.homes.1 – sethome.homes.10 |
false |
允许恰好 N 个家园(1, 2, 3, 5, 10) |
sethome.homes.unlimited |
OP |
允许无限数量的家园 |
? 家园数量解析规则
插件按以下顺序为每位玩家解析家园数量上限——匹配到第一条即生效:
| 优先级 |
来源 |
示例 |
| 1 |
权限节点 sethome.homes.unlimited |
→ 无限家园 |
| 2 |
最高数值权限节点 sethome.homes.N |
sethome.homes.10 → 10 个家园 |
| 3 |
在 rank-homes 配置中匹配的 LuckPerms 主组 |
group vip → 5 个家园 |
| 4 |
config.yml 中的 general.default-max-homes |
默认值 → 3 个家园 |
?️ GUI 概览
家园 GUI 是一个分页的 6 行物品栏。底部一行始终为导航栏;顶部 5 行显示家园物品。右键点击家园会在删除前打开一个 3 格的确认界面。
| 操作 |
行为 |
| 左键点击家园 |
关闭 GUI 并开始延迟传送 |
| 右键点击家园 |
打开删除确认 GUI(如果已启用) |
| 上一页 / 下一页箭头 |
浏览不同页的家园 |
| 屏障(关闭按钮) |
不执行任何操作直接关闭物品栏 |
⚙️ 配置特性
general:
language: en # en, de
default-max-homes: 3
teleport-delay: 3 # 传送前的倒计时秒数
cancel-on-move: true # 如果玩家移动则取消传送
sounds:
enabled: true
teleport: ENTITY_ENDERMAN_TELEPORT
set-home: BLOCK_ENCHANTMENT_TABLE_USE
delete-home: ENTITY_ITEM_BREAK
open-gui: BLOCK_CHEST_OPEN
error: ENTITY_VILLAGER_NO
particles:
enabled: true
type: PORTAL
count: 30
rank-homes:
default: 1
vip: 5
premium: 10
gui:
rows: 6
home-item: LIME_BED
filler-item: GRAY_STAINED_GLASS_PANE
show-coordinates: true
show-world: true
confirm:
enabled: true
confirm-item: LIME_CONCRETE
cancel-item: RED_CONCRETE
- 带移动取消检测的延迟传送倒计时
- 传送时在起点和终点生成粒子效果
- 基于 YAML 的玩家独立家园存储——无需数据库
- 家园名称验证:仅允许字母、数字、连字符和下划线;最大长度 24 个字符
- 所有家园名称参数支持 Tab 补全
- 所有音效和物品均可通过
config.yml 完全自定义
- 所有消息支持按语言自定义
? 语言支持
| 代码 |
语言 |
en |
?? English |
de |
?? Deutsch |
?️ 兼容性
| 服务端软件 |
版本 |
支持情况 |
| Paper |
1.21 – 1.21.x |
✅ |
| Purpur |
1.21 – 1.21.x |
✅ |
| Spigot |
1.21 – 1.21.x |
✅ |
| Bukkit |
1.21 – 1.21.x |
✅ |
| Folia |
1.21 – 1.21.x |
✅ |
需要 Java 21。LuckPerms 为可选的软依赖。
? 支持与更新:加入我们的 Discord
⌂ SetHomePlugin
SetHomePlugin is a clean, feature-rich home management plugin for Spigot/Paper servers. Players set named homes at any location and teleport back with a countdown, particles and sounds. Admins control per-rank home limits via LuckPerms or permission nodes — no manual config needed. A polished paginated GUI with delete-confirmation makes home management intuitive for every player.
⌨️ Commands
| Command |
Alias |
Permission |
Description |
Default |
/sethome <name> |
/sh |
sethome.use |
Save a home at your current location |
✅ All |
/home <name> |
/h |
sethome.use |
Teleport to a saved home |
✅ All |
/delhome <name> |
/deletehome, /removehome |
sethome.use |
Delete a saved home |
✅ All |
/homes |
/homelist, /listhomes |
sethome.use |
Open the paginated homes GUI |
✅ All |
/sethomereload |
/shreload |
sethome.admin |
Reload the plugin configuration |
? OP |
? Permissions
| Permission |
Default |
Description |
sethome.use |
All |
Use /sethome, /home, /delhome, /homes |
sethome.admin |
OP |
Reload config, bypass home limits |
sethome.homes.1 – sethome.homes.10 |
false |
Allow exactly N homes (1, 2, 3, 5, 10) |
sethome.homes.unlimited |
OP |
Allow unlimited homes |
? Home Limit Resolution
The plugin resolves the home limit for each player in this order — first match wins:
| Priority |
Source |
Example |
| 1 |
Permission node sethome.homes.unlimited |
→ unlimited homes |
| 2 |
Highest numeric permission node sethome.homes.N |
sethome.homes.10 → 10 homes |
| 3 |
LuckPerms primary group matched in rank-homes config |
group vip → 5 homes |
| 4 |
general.default-max-homes in config.yml |
default → 3 homes |
?️ GUI Overview
The homes GUI is a paginated 6-row inventory. The bottom row is always a navigation bar; the top 5 rows display home items. Right-clicking a home opens a 3-slot confirmation screen before deletion.
| Action |
Behavior |
| Left-click a home |
Close GUI and start delayed teleport |
| Right-click a home |
Open delete-confirmation GUI (if enabled) |
| Previous / Next arrows |
Page through homes |
| Barrier (close button) |
Close inventory without action |
⚙️ Config Features
general:
language: en # en, de
default-max-homes: 3
teleport-delay: 3 # seconds countdown before teleport
cancel-on-move: true # cancel teleport if player moves
sounds:
enabled: true
teleport: ENTITY_ENDERMAN_TELEPORT
set-home: BLOCK_ENCHANTMENT_TABLE_USE
delete-home: ENTITY_ITEM_BREAK
open-gui: BLOCK_CHEST_OPEN
error: ENTITY_VILLAGER_NO
particles:
enabled: true
type: PORTAL
count: 30
rank-homes:
default: 1
vip: 5
premium: 10
gui:
rows: 6
home-item: LIME_BED
filler-item: GRAY_STAINED_GLASS_PANE
show-coordinates: true
show-world: true
confirm:
enabled: true
confirm-item: LIME_CONCRETE
cancel-item: RED_CONCRETE
- Delayed teleport countdown with movement-cancel detection
- Particles spawn at both origin and destination on teleport
- Per-player YAML home storage — no database required
- Home names validated: letters, digits, hyphens, underscores; max 24 chars
- Tab-completion for all home name arguments
- All sounds and items fully configurable via
config.yml
- All messages customizable per language
? Language Support
| Code |
Language |
en |
?? English |
de |
?? Deutsch |
?️ Compatibility
| Server Software |
Version |
Supported |
| Paper |
1.21 – 1.21.x |
✅ |
| Purpur |
1.21 – 1.21.x |
✅ |
| Spigot |
1.21 – 1.21.x |
✅ |
| Bukkit |
1.21 – 1.21.x |
✅ |
| Folia |
1.21 – 1.21.x |
✅ |
Java 21 required. LuckPerms is an optional soft-dependency.
? Support & Updates: Join our Discord
评论 0
登录后参与评分
还没有评论,来抢沙发吧