Skip to content

Latest commit

 

History

History
257 lines (200 loc) · 7.82 KB

README.md

File metadata and controls

257 lines (200 loc) · 7.82 KB

ManyWorlds

Poggit Discord
Poggit Discord server
  • Summary: Manage Multiple Worlds
  • Dependency Plugins: n/a
  • PocketMine-MP: API 3.0.0 (and higher)
  • OptionalPlugins: n/a
  • Categories: Admin Tools, Teleportation
  • Plugin Access: Commands, Manages Worlds
  • WebSite: github

Overview

Full feature set of commands to manage multiple worlds.

Features:

  • teleport
  • load/unload
  • create
  • world info
  • edit level.dat

Basic Usage

  • create : Creates a new world
  • default : Sets the default world
  • fixname : fixes name mismatches
  • generators : List available world generators
  • load : Loads a world
  • ls : Provide world information
  • lvdat : Show/Modify level.dat variables
  • tp : Teleport to another world
  • unload : Unloads world

Documentation

This plugin is a world manager that allows you to generate and load worlds as well as teleport between worlds.

Command Reference

The following commands are available:

  • /mw create <world> [seed] [generator] [preset]
    Creates a new world

Creates a world named world. You can optionally specify a seed as number, the generator (flat or normal) and a preset string.

  • /mw default <world>
    Sets the default world

    Teleports you to another world. If player is specified, that player will be teleported.

  • /mw fixname <world>
    fixes name mismatches

    Fixes a world's level.dat file so that the name matches the folder name.

  • /mw generators
    List available world generators

    List registered world generators.

  • /mw load <world>
    Loads a world

    Loads world directly. Use --all to load all worlds.

  • /mw ls [world]
    Provide world information

    If world is not specified, it will list available worlds. Otherwise, details for world will be provided.

  • /mw lvdat <world> [attr=value]
    Show/Modify level.dat variables

    Change directly some level.dat values/attributes. Supported attributes:

    • spawn=x,y,z : Sets spawn point
    • seed=randomseed : seed used for terrain generation
    • name=string : Level name
    • generator=flat|normal : Terrain generator
    • preset=string : Presets string.
  • /mw tp [player] <world>
    Teleport to another world

    Teleports you to another world. If player is specified, that player will be teleported.

  • /mw unload [-f] <world>
    Unloads world

    Unloads world. Use -f to force unloads.

Permission Nodes

  • mw.cmds : Allow all the ManyWorlds functionality
  • mw.cmd.tp : Allows users to travel to other worlds (Defaults to Op)
  • mw.cmd.tp.others : Allows users to make others travel to other worlds (Defaults to Op)
  • mw.cmd.ls : Allows users to list worlds (Defaults to Op)
  • mw.cmd.world.create : Allows users to create worlds (Defaults to Op)
  • mw.cmd.world.load : Allows users to load worlds (Defaults to Op)
  • mw.cmd.lvdat : Manipulate level.dat (Defaults to Op)
  • mw.cmd.default : Changes default world (Defaults to Op)

Examples

Create a new normal world:

/mw create overworld 711 normal

Create a new flat world:

/mw create flatland 404 flat 2;7,59x1,3x3,2;1;

Teleport to this newly created world:

/mw tp flatland

Teleport a player to another world:

/mw tp joshua flatland

Translations

This plugin will follow the server language configuration. The languages currently available are:

  • English
  • Spanish

You can provide your own message file by creating a file called messages.ini in the pluginc config directory. Check github for sample files.

Issues

  • New world names can not contain spaces.

FAQ

  • Q: How do I create a FLAT world?

  • A: You must be using PocketMine-MP v1.4.1. Set the generator to flat.

  • Q: How do I load multiple worlds on start-up?

  • A: That functionality is provided by PocketMine-MP core by default. In the pocketmine.yml file there is a worlds section where you can define which worlds to load on start-up. Examples:

    [CODE]
    
    # pocketmine.yml
    worlds:
       world1: []
       world2: []
    [/CODE]
    

    This will automatically load worlds: "world1" and "world2" on startup.

Changes

  • 2.2.0: New API updates
  • 2.1.0: Updating to new API
  • 2.0.3: Bugfix update
    • Fixes bug reported by @thebigsmileXD
  • 2.0.2: Bug fix
    • Updated libcommon to 1.2.0dev1
      • This fixes a bug reported by @SoyPro. (#23)
      • Note this means that permissions defined in plugin.yml are applied properly which means all ManyWorlds sub commands are OP only.
  • 2.0.1: Bug fix
    • Changed command to manyworlds and mw is an alias. This is to prevent possible name collisions.
    • Completed Spanish translation.
    • Fixed crash (reported by @reyak)
  • 2.0.0: Modularization
    • Re-written for modularity
    • teleport manager API deprecated
    • Added default command to change the default level.
    • New genlist for list of generators
    • tp command changed to more natural English.
    • Translation: Spanish
  • 1.3.4: Updates for PM1.5
    • Removed CallbackTask deprecation warnings
  • 1.3.3: Updates for PM1.5
    • Minor cosmetic changes.
    • Changes default canUnload to true if running on PM1.5
    • Fixed use of WorldProtect limits + TeleportMgr
  • 1.3.2: API update
    • Allow WorldProtect to call our commands.
    • Simplified API and updated its documentation
  • 1.3.1:
    • Fixed a bug around not show who was teleported for 3rd party teleport
    • Fixed all bugs reported by Crash Archive
  • 1.3.0: Level.dat hacking.
    • Added lvdat command to change level.dat settings.
    • Added fixname command to fix levelName vs. foldername mismatches.
    • Fixed critical error for teleport!
  • 1.2.0: Clean-ups
    • Added a setting to control if to broadcast when people teleport.
    • Removed per-level motd.txt.
    • Code clean-up
    • Teleport functionality encapsulated in TeleportManager.
    • Added workaround to remove TileEntities that linger on when teleporting.
  • 1.1.0:
    • Show better help messages.
    • Added world unload. May cause core dumps.
    • ls sub-command improvements:
      • paginated output
      • show number of players, autoloading and default status.
    • Per-level motd.txt. Worlds can contain a small motd.txt text file that will be displayed when the player enters or when they type the /motd command.
    • Workaround teleport glitches, with a minimal API to let other plugins use this.
    • Added loadall functionality.
    • BugFix: given an invalid player name to teleport would crash server.
  • 1.0.0 : Initial release

Copyright

ManyWorlds
Copyright (C) 2015 Alejandro Liu
All Rights Reserved.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.