? AltWorlds: Your Universe, Your Rules
AltWorlds 重新定义了个人世界管理。忘掉那些复杂、臃肿的数据库系统吧。这是一款专业、轻量且完全基于 GUI 的插件,允许每位玩家在你的服务器中创建、管理和审核自己的“微型宇宙”。
从私有的 Survival(生存)世界到协作式的 Creative(创造)地块,再到 Custom Templates(自定义模板)。一切均通过直观的图形界面进行管理,专为现代服务器优化。
? 为什么选择 AltWorlds?
? 100% GUI 体验
你的玩家无需记忆任何指令。
- 向导式创建:分步骤选择类型、生成器和名称。
- 图标选择器:玩家可以直接在分页菜单中选择其世界的图标(方块/物品)。
- 游戏内菜单编辑器:你是管理员吗?在游戏内直接编辑主菜单图标(在编辑模式下 Shift+点击)。
?️ 深度的世界管理
这不仅仅是“创建一个世界”,而是对它的全面管理。
- 层级角色系统:
OWNER(所有者)、ADMIN(管理员)、MEMBER(成员)、VISITOR(访客)。
- 自我监管:所有者可以邀请、踢出并封禁(临时/永久)用户离开 他们自己 的世界。
- 即时切换功能:通过单击即可启用/禁用 PvP、飞行、饥饿、天气、FireTick、刷怪等功能。
⚡ 智能性能(“清洁工”机制)
建立在稳健的 生命周期系统 之上:
- 自动卸载:空世界会在可配置的冷却时间后自动从内存中卸载。
- 会话锁定:防止在加载/卸载循环或快速传送过程中发生数据损坏。
- 无数据库依赖:所有数据均以清晰、便携的 YAML 文件存储于
/data/players/ 中。轻松备份和迁移文件夹。
?️ 灵活的世界类型
- Vanilla:经典的生存体验。
- Creative:提供 Flat(平坦)或 Void(虚空,类似 Skyblock 风格)生成器选项。
- Templates:创建包含结构图(schematics)或预建地图的文件夹,让玩家克隆它们。
- Auto-Worlds:自动将特定世界分配给玩家(非常适合地块服务器或剧情服务器)。
? 详细功能
? 社交系统
- 世界探索者:按 点赞数、访问量、在线玩家数 或 类型 排序列出公共世界。
- 点赞系统:让玩家为他们喜欢的世界投票!
- 邀请系统:为私有世界提供安全的邀请功能。
? 大厅与家园
- 中央大厅:可将一个世界配置为大厅。包含一个可配置的背包物品用于打开菜单。
- 自动加入家园:玩家可以设置他们最喜爱的世界,以便在登录后直接加入,跳过大厅。
?️ 管理功能(服务器世界)
AltWorlds 不仅供玩家使用。作为管理员,你可以注册 “Server Worlds”(大厅、出生点、RPG 地图),使它们出现在菜单中,拥有独立的规则,并利用优化的传送系统。
? 指令与权限
该插件以 GUI 优先设计,但也为高级用户提供了强大的指令。
玩家指令 (altworlds.user)
| 指令 |
描述 |
/aw 或 /aw menu |
打开主控制面板。 |
/aw tp <world> |
传送到你的某个世界或公共世界。 |
/aw lobby |
返回服务器大厅。 |
/aw invite <player> |
邀请朋友加入你的私有世界。 |
/aw kick <player> |
将玩家从你的世界中踢出。 |
/aw ban <player> |
封禁(临时/永久)某玩家进入你的世界。 |
/aw sethome <world> |
设置你登录时自动加入的世界。 |
/aw setborder <radius> |
为你的世界设置可视边界。 |
/aw like |
对当前世界给予“点赞”。 |
管理员指令 (altworlds.admin)
| 指令 |
描述 |
/aw reload |
重载配置和模板。 |
/aw setlimit <user> <#> |
更改特定玩家的世界数量限制。 |
/aw tp <player:world> |
强制传送到其他玩家的世界。 |
| GUI 中 Shift+点击 |
编辑菜单图标、重新生成其他玩家的世界等。 |
? 安装与配置
- 下载
.jar 文件并将其放入 /plugins 文件夹。
- 重启服务器(推荐 Paper 1.21+)。
- 完成!配置文件将自动生成。
文件夹结构
config.yml:常规设置、限制、卸载计时器和消息。
data/:存储玩家数据和世界设置(YAML 格式)。
templates/:重要! 在此处放置你的世界文件夹(结构图/地图)以用作模板。
lobby/:如果你没有大厅,AltWorlds 可以为你自动生成一个虚空大厅。
如何添加模板
- 将一个世界文件夹(例如
SkyblockMap)复制到 plugins/AltWorlds/templates/ 中。
- 运行
/aw reload 或重启服务器。
- 它会自动出现在“创建世界”菜单中!
- (可选) 编辑
templates.yml 以更改其显示名称和图标。
⚙️ 高级配置
AltWorlds 允许你调整每一个细节。以下是 config.yml 中的示例:
? 点击此处展开完整的 config.yml
lobby:
# 大厅世界名称(文件夹/世界 ID)。值:任意世界名字符串。
worldName: "lobby"
# 如果不存在则自动创建大厅世界。值:true|false。
autoCreate: true
# 菜单项配置(默认为时钟)。
item:
# 玩家加入时给予菜单项。值:true|false。
giveOnJoin: true
# 菜单项的材质。值:任意 Bukkit 材质名称。
material: "CLOCK"
# 菜单项的背包栏位(快捷栏)。值:0-8。
slot: 8
# 给予物品的位置。值:LOBBY_ONLY 或 EVERYWHERE。
# LOBBY_ONLY:仅在大厅世界时(退出时移除)。
# EVERYWHERE:在任何世界中(适用于枢纽服)。
scope: "EVERYWHERE"
gui:
# 管理员菜单图标。值:任意 Bukkit 材质名称。
admin:
# “查看所有世界”的图标。
view_all: COMMAND_BLOCK
# “全局限制”的图标。
global_limit: ANVIL
# “管理玩家”的图标。
manage_players: PLAYER_HEAD
# “自定义此菜单”的图标。
customize: PAINTING
# 主菜单图标。值:任意 Bukkit 材质名称。
main:
# “我的世界”的图标。
my_worlds: WRITABLE_BOOK
# “探索世界”的图标。
explore: COMPASS
# “创建世界”的图标。
create: GRASS_BLOCK
# “大厅”的图标。
lobby: BEACON
# “全局世界图标”的图标。
global_settings: COMPARATOR
# “服务器世界”的图标。
server_worlds: NETHER_STAR
# “管理员设置”的图标。
admin: COMMAND_BLOCK
# “自动加入家园”的图标。
auto_join: REPEATER
# “当前世界”的图标。
current_world: COMPARATOR
# “自定义菜单”的图标。
customize: PAINTING
# 探索菜单图标。值:任意 Bukkit 材质名称。
explore:
# “排序:玩家”的图标。
sort_players: PLAYER_HEAD
# “排序:点赞数”的图标。
sort_likes: EMERALD
# “排序:访问量”的图标。
sort_visits: OAK_SIGN
# “排序:类型”的图标。
sort_type: PAPER
# “自定义菜单”的图标。
customize: PAINTING
# 创建菜单图标(分类)。值:任意 Bukkit 材质名称。
create:
# “原版”的图标。
vanilla: OAK_SAPLING
# “模板”的图标。
templates: PAPER
# “创造模式”的图标。
creative: DIAMOND_BLOCK
# “管理员 / 私有”的图标。
admin: COMMAND_BLOCK
# “自定义菜单”的图标。
customize: PAINTING
# 创造模式选项菜单图标。值:任意 Bukkit 材质名称。
creative:
# “原版创造模式”的图标。
vanilla: GRASS_BLOCK
# “平坦创造模式”的图标。
flat: SANDSTONE
# “虚空创造模式”的图标。
void: GLASS
# “自定义菜单”的图标。
customize: PAINTING
# 世界设置图标。值:任意 Bukkit 材质名称。
settings:
# “游戏模式”的图标。
gamemode: GOLDEN_APPLE
# “PvP”的图标。
pvp: IRON_SWORD
# “飞行”的图标。
fly: FEATHER
# “饥饿”的图标。
hunger: ROTTEN_FLESH
# “坠落伤害”的图标。
fallDamage: LEATHER_BOOTS
# “药水效果”的图标。
potions: BREWING_STAND
# “允许访客”的图标。
allowVisitors: OAK_DOOR
# “公开列表”的图标。
public: GLOBE_BANNER_PATTERN
# “日夜循环”的图标。
doDaylightCycle: CLOCK
# “天气循环”的图标。
doWeatherCycle: WATER_BUCKET
# “火焰蔓延”的图标。
doFireTick: FLINT_AND_STEEL
# “生物破坏方块”的图标。
mobGriefing: CREEPER_HEAD
# “保留物品栏”的图标。
keepInventory: CHEST
# “生物生成”的图标。
doMobSpawning: ZOMBIE_HEAD
# “方块掉落”的图标。
doTileDrops: GRAVEL
# “作物生长速度”的图标。
randomTickSpeed: WHEAT
# “世界边界”的图标。
border: IRON_BARS
login:
# 如果为 true,加入时始终跳过大厅。值:true|false。
forceSkipLobby: false
# 如果为 true,玩家可以从 GUI 切换自动加入家园。值:true|false。
allowUserSkipToggle: false
# -------------------------------------------------------------
# 自动世界
# -------------------------------------------------------------
auto-worlds:
# 启用自动世界。值:true|false。
enabled: true
# 如果为 true,每次加入时复制自动世界。值:true|false。
copyOnEveryJoin: true
# 自动世界是否计入玩家的最大世界限制。值:true|false。
countTowardsLimit: false
# 自动世界的特殊权限。
permissions:
# 允许用户删除自动世界。值:true|false。
allowDelete: false
# 允许用户重新生成自动世界。值:true|false。
allowRegen: false
# -------------------------------------------------------------
# 所有世界
# -------------------------------------------------------------
all-worlds:
# 全服世界是否计入玩家限制。值:true|false。
countTowardsLimit: false
# -------------------------------------------------------------
# 传送
# -------------------------------------------------------------
teleport:
# 传送延迟(秒)。值:整数 >= 0。
delay: 3
# 如果玩家移动则取消传送。值:true|false。
cancelOnMove: false
# -------------------------------------------------------------
# 限制
# -------------------------------------------------------------
restrictions:
# 允许重命名世界。值:true|false。
allowRenaming: true
creation:
# 允许创建生存世界。值:true|false。
allowSurvival: true
# 允许创建模板世界。值:true|false。
allowTemplates: true
# 允许创建创造模式世界。值:true|false。
allowCreative: true
creative:
# 允许原版创造模式世界。值:true|false。
vanilla: true
# 允许平坦创造模式世界。值:true|false。
flat: true
# 允许虚空创造模式世界。值:true|false。
void: true
names:
# 世界名称的最小长度。取值:大于等于 1 的整数。
minLength: 3
# 世界名称的最大长度。取值:大于等于 minLength 的整数。
maxLength: 16
# 允许的名称正则表达式。取值:正则字符串。
regex: "^[a-zA-Z0-9_-]+$"
# 无效名称的错误提示(支持颜色代码)。取值:字符串。
errorMessage: "&c无效的名称!请使用 a-z、0-9、_ 或 -(3-16 个字符)。"
# -------------------------------------------------------------
# 限制与邀请
# -------------------------------------------------------------
limits:
# 每个玩家默认的世界数量上限。取值:大于等于 -1 的整数(-1 = 无限制)。
maxWorldsPerPlayer: 3
# 如果为 true,已加入/被邀请的世界计入最大限制。取值:true|false。
invitedWorldsCount: false
invitations:
# 邀请过期时间(秒)。取值:大于等于 0 的整数。
timeout: 60
# -------------------------------------------------------------
# 封禁
# -------------------------------------------------------------
bans:
# 临时封禁菜单预设。格式示例:30s, 10m, 2h, 1d。
temp-presets:
- "5m"
- "30m"
- "1h"
- "6h"
- "1d"
- "7d"
defaults:
# 每个玩家默认的世界数量上限(回退值)。取值:大于等于 -1 的整数。
maxWorldsPerPlayer: 3
# 默认成员游戏模式。取值:SURVIVAL|CREATIVE|ADVENTURE|SPECTATOR。
memberGamemode: "SURVIVAL"
# 默认访客游戏模式。取值:SURVIVAL|CREATIVE|ADVENTURE|SPECTATOR。
visitorGamemode: "SPECTATOR"
# 生成新世界配置时使用的默认设置。
world-defaults:
survival:
# 生存世界的默认游戏模式。取值:SURVIVAL|CREATIVE|ADVENTURE|SPECTATOR。
gamemode: SURVIVAL
# 允许 PvP。取值:true|false。
pvp: true
# 允许飞行。取值:true|false。
fly: false
# 启用饥饿消耗。取值:true|false。
hunger: true
# 启用摔落伤害。取值:true|false。
fallDamage: true
# 允许使用药水。取值:true|false。
potions: true
# 允许访客加入。取值:true|false。
allowVisitors: true
# 显示在公共列表中。取值:true|false。
public: true
# 昼夜循环。取值:true|false。
doDaylightCycle: true
# 天气循环。取值:true|false。
doWeatherCycle: true
# 火焰蔓延。取值:true|false。
doFireTick: true
# 生物破坏方块(苦力怕等)。取值:true|false。
mobGriefing: true
# 死亡保留物品栏。取值:true|false。
keepInventory: true
# 自然生物生成。取值:true|false。
doMobSpawning: true
# 方块掉落。取值:true|false。
doTileDrops: true
# 作物生长(刻速度)。取值:true|false。
randomTickSpeed: true
creative:
# 创造世界的默认游戏模式。取值:SURVIVAL|CREATIVE|ADVENTURE|SPECTATOR。
gamemode: CREATIVE
# 允许 PvP。取值:true|false。
pvp: false
# 允许飞行。取值:true|false。
fly: true
# 启用饥饿消耗。取值:true|false。
hunger: false
# 启用摔落伤害。取值:true|false。
fallDamage: false
# 允许使用药水。取值:true|false。
potions: true
# 允许访客加入。取值:true|false。
allowVisitors: true
# 显示在公共列表中。取值:true|false。
public: true
# 昼夜循环。取值:true|false。
doDaylightCycle: true
# 天气循环。取值:true|false。
doWeatherCycle: false
# 火焰蔓延。取值:true|false。
doFireTick: false
# 生物破坏方块(苦力怕等)。取值:true|false。
mobGriefing: false
# 死亡保留物品栏。取值:true|false。
keepInventory: true
# 自然生物生成。取值:true|false。
doMobSpawning: false
# 方块掉落。取值:true|false。
doTileDrops: false
# 作物生长(刻速度)。取值:true|false。
randomTickSpeed: false
templates:
# 模板世界的默认游戏模式。取值:SURVIVAL|CREATIVE|ADVENTURE|SPECTATOR。
gamemode: SURVIVAL
# 允许 PvP。取值:true|false。
pvp: true
# 允许飞行。取值:true|false。
fly: false
# 启用饥饿消耗。取值:true|false。
hunger: true
# 启用摔落伤害。取值:true|false。
fallDamage: true
# 允许使用药水。取值:true|false。
potions: true
# 允许访客加入。取值:true|false。
allowVisitors: true
# 显示在公共列表中。取值:true|false。
public: true
# 昼夜循环。取值:true|false。
doDaylightCycle: true
# 天气循环。取值:true|false。
doWeatherCycle: true
# 火焰蔓延。取值:true|false。
doFireTick: true
# 生物破坏方块(苦力怕等)。取值:true|false。
mobGriefing: true
# 死亡保留物品栏。取值:true|false。
keepInventory: true
# 自然生物生成。取值:true|false。
doMobSpawning: true
# 方块掉落。取值:true|false。
doTileDrops: true
# 作物生长(刻速度)。取值:true|false。
randomTickSpeed: true
all-worlds:
# 服务器/所有世界的默认游戏模式。可选值:SURVIVAL|CREATIVE|ADVENTURE|SPECTATOR.
gamemode: SURVIVAL
# 允许玩家对战 (PvP)。可选值:true|false.
pvp: true
# 允许飞行。可选值:true|false.
fly: false
# 启用饥饿度消耗。可选值:true|false.
hunger: true
# 启用坠落伤害。可选值:true|false.
fallDamage: true
# 允许使用药水。可选值:true|false.
potions: true
# 允许访客加入。可选值:true|false.
allowVisitors: true
# 在公共列表中显示。可选值:true|false.
public: true
# 昼夜循环。可选值:true|false.
doDaylightCycle: true
# 天气循环。可选值:true|false.
doWeatherCycle: true
# 火焰蔓延。可选值:true|false.
doFireTick: true
# 生物破坏(苦力怕等)。可选值:true|false.
mobGriefing: true
# 死亡时保留物品栏。可选值:true|false.
keepInventory: true
# 自然生成生物。可选值:true|false.
doMobSpawning: true
# 方块破碎掉落物品。可选值:true|false.
doTileDrops: true
# 作物生长(刻速)。可选值:true|false.
randomTickSpeed: true
auto-worlds:
# 自动创建世界的默认游戏模式。可选值:SURVIVAL|CREATIVE|ADVENTURE|SPECTATOR.
gamemode: SURVIVAL
# 允许玩家对战 (PvP)。可选值:true|false.
pvp: true
# 允许飞行。可选值:true|false.
fly: false
# 启用饥饿度消耗。可选值:true|false.
hunger: true
# 启用坠落伤害。可选值:true|false.
fallDamage: true
# 允许使用药水。可选值:true|false.
potions: true
# 允许访客加入。可选值:true|false.
allowVisitors: true
# 在公共列表中显示。可选值:true|false.
public: true
# 昼夜循环。可选值:true|false.
doDaylightCycle: true
# 天气循环。可选值:true|false.
doWeatherCycle: true
# 火焰蔓延。可选值:true|false.
doFireTick: true
# 生物破坏(苦力怕等)。可选值:true|false.
mobGriefing: true
# 死亡时保留物品栏。可选值:true|false.
keepInventory: true
# 自然生成生物。可选值:true|false.
doMobSpawning: true
# 方块破碎掉落物品。可选值:true|false.
doTileDrops: true
# 作物生长(刻速)。可选值:true|false.
randomTickSpeed: true
private-worlds:
# 私有模板的默认游戏模式。可选值:SURVIVAL|CREATIVE|ADVENTURE|SPECTATOR.
gamemode: CREATIVE
# 允许玩家对战 (PvP)。可选值:true|false.
pvp: false
# 允许飞行。可选值:true|false.
fly: true
# 启用饥饿度消耗。可选值:true|false.
hunger: false
# 启用坠落伤害。可选值:true|false.
fallDamage: false
# 允许使用药水。可选值:true|false.
potions: true
# 允许访客加入。可选值:true|false.
allowVisitors: true
# 在公共列表中显示。可选值:true|false.
public: true
# 昼夜循环。可选值:true|false.
doDaylightCycle: true
# 天气循环。可选值:true|false.
doWeatherCycle: false
# 火焰蔓延。可选值:true|false.
doFireTick: false
# 生物破坏(苦力怕等)。可选值:true|false.
mobGriefing: false
# 死亡时保留物品栏。可选值:true|false.
keepInventory: true
# 自然生成生物。可选值:true|false.
doMobSpawning: false
# 方块破碎掉落物品。可选值:true|false.
doTileDrops: false
# 作物生长(刻速)。可选值:true|false.
randomTickSpeed: false
lobby:
# 大厅的默认游戏模式。可选值:SURVIVAL|CREATIVE|ADVENTURE|SPECTATOR.
gamemode: ADVENTURE
# 允许玩家对战 (PvP)。可选值:true|false.
pvp: false
# 允许飞行。可选值:true|false.
fly: false
# 启用饥饿度消耗。可选值:true|false.
hunger: false
# 启用坠落伤害。可选值:true|false.
fallDamage: false
# 允许使用药水。可选值:true|false.
potions: false
# 允许访客加入。可选值:true|false.
allowVisitors: true
# 在公共列表中显示。可选值:true|false.
public: false
# 昼夜循环。可选值:true|false.
doDaylightCycle: false
# 天气循环。可选值:true|false.
doWeatherCycle: false
# 火焰蔓延。可选值:true|false.
doFireTick: false
# 生物破坏(苦力怕等)。可选值:true|false.
mobGriefing: false
# 死亡时保留物品栏。可选值:true|false.
keepInventory: true
# 自然生成生物。可选值:true|false.
doMobSpawning: false
# 方块破碎掉落物品。可选值:true|false.
doTileDrops: false
# 作物生长(刻速)。可选值:true|false.
randomTickSpeed: false
performance:
# 当世界为空时卸载世界。可选值:true|false.
unloadWorldsWhenEmpty: true
# 卸载空世界前的延迟时间(秒)。可选值:大于等于 0 的整数.
unloadDelaySeconds: 45
# 世界可被卸载前必须保持的最短在线时长(秒)。可选值:大于等于 0 的整数.
minWorldUptimeSeconds: 60
# 创建世界时预加载出生点区块。可选值:true|false.
preloadSpawnChunksOnCreate: true
</details>
? AltWorlds: Your Universe, Your Rules
AltWorlds redefines personal world management. Forget about complex, heavy database systems. This is a professional, lightweight, and fully GUI-based plugin that allows every player to create, manage, and moderate their own "mini-universes" within your server.
From private Survival worlds to collaborative Creative plots, including Custom Templates. Everything is managed through an intuitive graphical interface, optimized for modern servers.
? Why choose AltWorlds?
? 100% GUI Experience
Your players don't need to memorize commands.
- Wizard-Style Creation: Choose type, generator, and name step-by-step.
- Icon Selector: Players can pick the icon for their world (blocks/items) directly from a paginated menu.
- In-Game Menu Editor: Are you an admin? Edit the main menu icons directly in-game (Shift+Click in edit mode).
?️ Deep World Management
It's not just about "creating a world." It's about managing it.
- Hierarchical Roles:
OWNER, ADMIN, MEMBER, VISITOR.
- Self-Moderation: Owners can invite, kick, and ban (Temp/Perm) users from their own worlds.
- On-the-fly Toggles: Enable/disable PvP, Flight, Hunger, Weather, FireTick, Spawning, and more with a single click.
⚡ Smart Performance ("The Janitor")
Built on a robust Lifecycle System:
- Auto-Unload: Empty worlds are automatically unloaded from RAM after a configurable cooldown.
- Session Locking: Prevents corruption during load/unload cycles or rapid teleports.
- No Database: Everything is stored in clean, portable YAML files (
/data/players/). Backup and transfer folders with ease.
?️ Flexible World Types
- Vanilla: Classic Survival experience.
- Creative: With Flat or Void (Skyblock style) generator options.
- Templates: Create folders with schematics or pre-built maps and let players clone them.
- Auto-Worlds: Automatically assign specific worlds to players (ideal for plot servers or storylines).
? Detailed Features
? Social System
- World Explorer: List public worlds sorted by Likes, Visits, Online Players, or Type.
- Like System: Let players vote for their favorite worlds!
- Invites: Secure invitation system for private worlds.
? Lobby & Home
- Central Lobby: Configure a world as the Lobby. Includes a configurable inventory item to open the menu.
- Auto-Join Home: Players can set their favorite world to join directly upon login, skipping the lobby.
?️ Administration (Server Worlds)
AltWorlds isn't just for players. As an admin, you can register "Server Worlds" (Lobbies, Spawns, RPG maps) so they appear in menus, have their own rules, and benefit from the optimized teleportation system.
? Commands & Permissions
The plugin is designed to be GUI-first, but includes powerful commands for power users.
Player Commands (altworlds.user)
| Command |
Description |
/aw or /aw menu |
Opens the Main Control Panel. |
/aw tp <world> |
Travel to one of your worlds or a public one. |
/aw lobby |
Return to the server Lobby. |
/aw invite <player> |
Invite a friend to your private world. |
/aw kick <player> |
Kick a player from your world. |
/aw ban <player> |
Ban (Temp/Perm) a player from your world. |
/aw sethome <world> |
Set your auto-join login world. |
/aw setborder <radius> |
Set a visual border for your world. |
/aw like |
Give a "Like" to the current world. |
Admin Commands (altworlds.admin)
| Command |
Description |
/aw reload |
Reloads configuration and templates. |
/aw setlimit <user> <#> |
Changes the world limit for a specific player. |
/aw tp <player:world> |
Forced teleport to other players' worlds. |
| Shift+Click in GUI |
Edit menu icons, regenerate other players' worlds, etc. |
? Installation & Configuration
- Download the
.jar and place it in your /plugins folder.
- Restart your server (Paper 1.21+ recommended).
- Done! Configuration files will be generated automatically.
Folder Structure
config.yml: General settings, limits, unload timers, and messages.
data/: Stores player data and world settings (YAML).
templates/: Important! Place your world folders (schematics/maps) here to use them as templates.
lobby/: If you don't have a lobby, AltWorlds can auto-generate a void lobby for you.
How to add Templates
- Copy a world folder (e.g.,
SkyblockMap) into plugins/AltWorlds/templates/.
- Run
/aw reload or restart.
- It will automatically appear in the "Create World" menu!
- (Optional) Edit
templates.yml to change its display name and icon.
⚙️ Advanced Configuration
AltWorlds allows you to tweak every detail. Example from config.yml:
? Click here to expand the full config.yml
lobby:
# Lobby world name (folder/world id). Values: any world name string.
worldName: "lobby"
# Auto-create the lobby world if it does not exist. Values: true|false.
autoCreate: true
# Menu item configuration (clock by default).
item:
# Give the menu item to players when they join. Values: true|false.
giveOnJoin: true
# Material for the menu item. Values: any Bukkit Material name.
material: "CLOCK"
# Inventory slot for the menu item (hotbar). Values: 0-8.
slot: 8
# Where to give the item. Values: LOBBY_ONLY or EVERYWHERE.
# LOBBY_ONLY: only while in lobby world (removed on exit).
# EVERYWHERE: in any world (useful for hubs).
scope: "EVERYWHERE"
gui:
# Admin menu icons. Values: any Bukkit Material name.
admin:
# Icon for "View All Worlds".
view_all: COMMAND_BLOCK
# Icon for "Global Limit".
global_limit: ANVIL
# Icon for "Manage Players".
manage_players: PLAYER_HEAD
# Icon for "Customize This Menu".
customize: PAINTING
# Main menu icons. Values: any Bukkit Material name.
main:
# Icon for "My Worlds".
my_worlds: WRITABLE_BOOK
# Icon for "Explore Worlds".
explore: COMPASS
# Icon for "Create World".
create: GRASS_BLOCK
# Icon for "Lobby".
lobby: BEACON
# Icon for "Global World Icons".
global_settings: COMPARATOR
# Icon for "Server Worlds".
server_worlds: NETHER_STAR
# Icon for "Admin Settings".
admin: COMMAND_BLOCK
# Icon for "Auto-Join Home".
auto_join: REPEATER
# Icon for "Current World".
current_world: COMPARATOR
# Icon for "Customize Menu".
customize: PAINTING
# Explore menu icons. Values: any Bukkit Material name.
explore:
# Icon for "Sort: Players".
sort_players: PLAYER_HEAD
# Icon for "Sort: Likes".
sort_likes: EMERALD
# Icon for "Sort: Visits".
sort_visits: OAK_SIGN
# Icon for "Sort: Type".
sort_type: PAPER
# Icon for "Customize Menu".
customize: PAINTING
# Create menu icons (categories). Values: any Bukkit Material name.
create:
# Icon for "Vanilla".
vanilla: OAK_SAPLING
# Icon for "Templates".
templates: PAPER
# Icon for "Creative".
creative: DIAMOND_BLOCK
# Icon for "Admin / Private".
admin: COMMAND_BLOCK
# Icon for "Customize Menu".
customize: PAINTING
# Creative options menu icons. Values: any Bukkit Material name.
creative:
# Icon for "Vanilla Creative".
vanilla: GRASS_BLOCK
# Icon for "Flat Creative".
flat: SANDSTONE
# Icon for "Void Creative".
void: GLASS
# Icon for "Customize Menu".
customize: PAINTING
# World settings icons. Values: any Bukkit Material name.
settings:
# Icon for "Gamemode".
gamemode: GOLDEN_APPLE
# Icon for "PvP".
pvp: IRON_SWORD
# Icon for "Fly".
fly: FEATHER
# Icon for "Hunger".
hunger: ROTTEN_FLESH
# Icon for "Fall Damage".
fallDamage: LEATHER_BOOTS
# Icon for "Potions".
potions: BREWING_STAND
# Icon for "Allow Visitors".
allowVisitors: OAK_DOOR
# Icon for "Public Listing".
public: GLOBE_BANNER_PATTERN
# Icon for "Day/Night Cycle".
doDaylightCycle: CLOCK
# Icon for "Weather Cycle".
doWeatherCycle: WATER_BUCKET
# Icon for "Fire Spread".
doFireTick: FLINT_AND_STEEL
# Icon for "Mob Griefing".
mobGriefing: CREEPER_HEAD
# Icon for "Keep Inventory".
keepInventory: CHEST
# Icon for "Mob Spawning".
doMobSpawning: ZOMBIE_HEAD
# Icon for "Block Drops".
doTileDrops: GRAVEL
# Icon for "Crop Growth".
randomTickSpeed: WHEAT
# Icon for "World Border".
border: IRON_BARS
login:
# If true, always skip the lobby on join. Values: true|false.
forceSkipLobby: false
# If true, players can toggle auto-join home from the GUI. Values: true|false.
allowUserSkipToggle: false
# -------------------------------------------------------------
# AUTO-WORLDS
# -------------------------------------------------------------
auto-worlds:
# Enable auto-worlds. Values: true|false.
enabled: true
# If true, auto-worlds are copied for each join. Values: true|false.
copyOnEveryJoin: true
# Whether auto-worlds count toward the player's max world limit. Values: true|false.
countTowardsLimit: false
# Special permissions for auto-worlds.
permissions:
# Allow users to delete auto-worlds. Values: true|false.
allowDelete: false
# Allow users to regenerate auto-worlds. Values: true|false.
allowRegen: false
# -------------------------------------------------------------
# ALL-WORLDS
# -------------------------------------------------------------
all-worlds:
# Whether server-wide worlds count toward player limits. Values: true|false.
countTowardsLimit: false
# -------------------------------------------------------------
# TELEPORTATION
# -------------------------------------------------------------
teleport:
# Teleport delay in seconds. Values: integer >= 0.
delay: 3
# Cancel teleport if player moves. Values: true|false.
cancelOnMove: false
# -------------------------------------------------------------
# RESTRICTIONS
# -------------------------------------------------------------
restrictions:
# Allow renaming worlds. Values: true|false.
allowRenaming: true
creation:
# Allow survival world creation. Values: true|false.
allowSurvival: true
# Allow template world creation. Values: true|false.
allowTemplates: true
# Allow creative world creation. Values: true|false.
allowCreative: true
creative:
# Allow vanilla creative worlds. Values: true|false.
vanilla: true
# Allow flat creative worlds. Values: true|false.
flat: true
# Allow void creative worlds. Values: true|false.
void: true
names:
# Minimum world name length. Values: integer >= 1.
minLength: 3
# Maximum world name length. Values: integer >= minLength.
maxLength: 16
# Regex for allowed names. Values: regex string.
regex: "^[a-zA-Z0-9_-]+$"
# Error message for invalid names (supports color codes). Values: string.
errorMessage: "&cInvalid name! Use a-z, 0-9, _ or - (3-16 chars)."
# -------------------------------------------------------------
# LIMITS & INVITATIONS
# -------------------------------------------------------------
limits:
# Default max worlds per player. Values: integer >= -1 (-1 = unlimited).
maxWorldsPerPlayer: 3
# If true, joined/invited worlds count toward max limit. Values: true|false.
invitedWorldsCount: false
invitations:
# Invitation expiration in seconds. Values: integer >= 0.
timeout: 60
# -------------------------------------------------------------
# BANS
# -------------------------------------------------------------
bans:
# Presets for temporary ban menu. Format examples: 30s, 10m, 2h, 1d.
temp-presets:
- "5m"
- "30m"
- "1h"
- "6h"
- "1d"
- "7d"
defaults:
# Default max worlds per player (fallback). Values: integer >= -1.
maxWorldsPerPlayer: 3
# Default member gamemode. Values: SURVIVAL|CREATIVE|ADVENTURE|SPECTATOR.
memberGamemode: "SURVIVAL"
# Default visitor gamemode. Values: SURVIVAL|CREATIVE|ADVENTURE|SPECTATOR.
visitorGamemode: "SPECTATOR"
# Default settings used when generating new world configs.
world-defaults:
survival:
# Default gamemode for survival worlds. Values: SURVIVAL|CREATIVE|ADVENTURE|SPECTATOR.
gamemode: SURVIVAL
# Allow PvP. Values: true|false.
pvp: true
# Allow flight. Values: true|false.
fly: false
# Enable hunger loss. Values: true|false.
hunger: true
# Enable fall damage. Values: true|false.
fallDamage: true
# Allow potion usage. Values: true|false.
potions: true
# Allow visitors to join. Values: true|false.
allowVisitors: true
# Show in public listings. Values: true|false.
public: true
# Day/night cycle. Values: true|false.
doDaylightCycle: true
# Weather cycle. Values: true|false.
doWeatherCycle: true
# Fire spread. Values: true|false.
doFireTick: true
# Mob griefing (creepers, etc.). Values: true|false.
mobGriefing: true
# Keep inventory on death. Values: true|false.
keepInventory: true
# Natural mob spawning. Values: true|false.
doMobSpawning: true
# Block drops on break. Values: true|false.
doTileDrops: true
# Crop growth (tick speed). Values: true|false.
randomTickSpeed: true
creative:
# Default gamemode for creative worlds. Values: SURVIVAL|CREATIVE|ADVENTURE|SPECTATOR.
gamemode: CREATIVE
# Allow PvP. Values: true|false.
pvp: false
# Allow flight. Values: true|false.
fly: true
# Enable hunger loss. Values: true|false.
hunger: false
# Enable fall damage. Values: true|false.
fallDamage: false
# Allow potion usage. Values: true|false.
potions: true
# Allow visitors to join. Values: true|false.
allowVisitors: true
# Show in public listings. Values: true|false.
public: true
# Day/night cycle. Values: true|false.
doDaylightCycle: true
# Weather cycle. Values: true|false.
doWeatherCycle: false
# Fire spread. Values: true|false.
doFireTick: false
# Mob griefing (creepers, etc.). Values: true|false.
mobGriefing: false
# Keep inventory on death. Values: true|false.
keepInventory: true
# Natural mob spawning. Values: true|false.
doMobSpawning: false
# Block drops on break. Values: true|false.
doTileDrops: false
# Crop growth (tick speed). Values: true|false.
randomTickSpeed: false
templates:
# Default gamemode for template worlds. Values: SURVIVAL|CREATIVE|ADVENTURE|SPECTATOR.
gamemode: SURVIVAL
# Allow PvP. Values: true|false.
pvp: true
# Allow flight. Values: true|false.
fly: false
# Enable hunger loss. Values: true|false.
hunger: true
# Enable fall damage. Values: true|false.
fallDamage: true
# Allow potion usage. Values: true|false.
potions: true
# Allow visitors to join. Values: true|false.
allowVisitors: true
# Show in public listings. Values: true|false.
public: true
# Day/night cycle. Values: true|false.
doDaylightCycle: true
# Weather cycle. Values: true|false.
doWeatherCycle: true
# Fire spread. Values: true|false.
doFireTick: true
# Mob griefing (creepers, etc.). Values: true|false.
mobGriefing: true
# Keep inventory on death. Values: true|false.
keepInventory: true
# Natural mob spawning. Values: true|false.
doMobSpawning: true
# Block drops on break. Values: true|false.
doTileDrops: true
# Crop growth (tick speed). Values: true|false.
randomTickSpeed: true
all-worlds:
# Default gamemode for server/all worlds. Values: SURVIVAL|CREATIVE|ADVENTURE|SPECTATOR.
gamemode: SURVIVAL
# Allow PvP. Values: true|false.
pvp: true
# Allow flight. Values: true|false.
fly: false
# Enable hunger loss. Values: true|false.
hunger: true
# Enable fall damage. Values: true|false.
fallDamage: true
# Allow potion usage. Values: true|false.
potions: true
# Allow visitors to join. Values: true|false.
allowVisitors: true
# Show in public listings. Values: true|false.
public: true
# Day/night cycle. Values: true|false.
doDaylightCycle: true
# Weather cycle. Values: true|false.
doWeatherCycle: true
# Fire spread. Values: true|false.
doFireTick: true
# Mob griefing (creepers, etc.). Values: true|false.
mobGriefing: true
# Keep inventory on death. Values: true|false.
keepInventory: true
# Natural mob spawning. Values: true|false.
doMobSpawning: true
# Block drops on break. Values: true|false.
doTileDrops: true
# Crop growth (tick speed). Values: true|false.
randomTickSpeed: true
auto-worlds:
# Default gamemode for auto-worlds. Values: SURVIVAL|CREATIVE|ADVENTURE|SPECTATOR.
gamemode: SURVIVAL
# Allow PvP. Values: true|false.
pvp: true
# Allow flight. Values: true|false.
fly: false
# Enable hunger loss. Values: true|false.
hunger: true
# Enable fall damage. Values: true|false.
fallDamage: true
# Allow potion usage. Values: true|false.
potions: true
# Allow visitors to join. Values: true|false.
allowVisitors: true
# Show in public listings. Values: true|false.
public: true
# Day/night cycle. Values: true|false.
doDaylightCycle: true
# Weather cycle. Values: true|false.
doWeatherCycle: true
# Fire spread. Values: true|false.
doFireTick: true
# Mob griefing (creepers, etc.). Values: true|false.
mobGriefing: true
# Keep inventory on death. Values: true|false.
keepInventory: true
# Natural mob spawning. Values: true|false.
doMobSpawning: true
# Block drops on break. Values: true|false.
doTileDrops: true
# Crop growth (tick speed). Values: true|false.
randomTickSpeed: true
private-worlds:
# Default gamemode for private templates. Values: SURVIVAL|CREATIVE|ADVENTURE|SPECTATOR.
gamemode: CREATIVE
# Allow PvP. Values: true|false.
pvp: false
# Allow flight. Values: true|false.
fly: true
# Enable hunger loss. Values: true|false.
hunger: false
# Enable fall damage. Values: true|false.
fallDamage: false
# Allow potion usage. Values: true|false.
potions: true
# Allow visitors to join. Values: true|false.
allowVisitors: true
# Show in public listings. Values: true|false.
public: true
# Day/night cycle. Values: true|false.
doDaylightCycle: true
# Weather cycle. Values: true|false.
doWeatherCycle: false
# Fire spread. Values: true|false.
doFireTick: false
# Mob griefing (creepers, etc.). Values: true|false.
mobGriefing: false
# Keep inventory on death. Values: true|false.
keepInventory: true
# Natural mob spawning. Values: true|false.
doMobSpawning: false
# Block drops on break. Values: true|false.
doTileDrops: false
# Crop growth (tick speed). Values: true|false.
randomTickSpeed: false
lobby:
# Default gamemode for lobby. Values: SURVIVAL|CREATIVE|ADVENTURE|SPECTATOR.
gamemode: ADVENTURE
# Allow PvP. Values: true|false.
pvp: false
# Allow flight. Values: true|false.
fly: false
# Enable hunger loss. Values: true|false.
hunger: false
# Enable fall damage. Values: true|false.
fallDamage: false
# Allow potion usage. Values: true|false.
potions: false
# Allow visitors to join. Values: true|false.
allowVisitors: true
# Show in public listings. Values: true|false.
public: false
# Day/night cycle. Values: true|false.
doDaylightCycle: false
# Weather cycle. Values: true|false.
doWeatherCycle: false
# Fire spread. Values: true|false.
doFireTick: false
# Mob griefing (creepers, etc.). Values: true|false.
mobGriefing: false
# Keep inventory on death. Values: true|false.
keepInventory: true
# Natural mob spawning. Values: true|false.
doMobSpawning: false
# Block drops on break. Values: true|false.
doTileDrops: false
# Crop growth (tick speed). Values: true|false.
randomTickSpeed: false
performance:
# Unload worlds when empty. Values: true|false.
unloadWorldsWhenEmpty: true
# Delay before unloading empty worlds (seconds). Values: integer >= 0.
unloadDelaySeconds: 45
# Minimum uptime before a world can be unloaded (seconds). Values: integer >= 0.
minWorldUptimeSeconds: 60
# Preload spawn chunks when creating a world. Values: true|false.
preloadSpawnChunksOnCreate: true
</details>
评论 0
登录后参与评分
还没有评论,来抢沙发吧