Bukkit

Read carefully! Everything you need to install AdvenTour will be in this guide!

A guide to the config file will be at the bottom of this page

1. Download the latest build from the front page
2. Put the AdvenTour.jar file in your plugins folder
3. Start your server and stop it again. AdvenTour has now created a config.yml file in your plugins/AdvenTour folder. Edit it to fit your needs.
4. Start your server
5. Join and create a portal of obsidian. Either light it or place portal blocks (ID 90) for custom designs
6. Place a sign on the obsidian above each vertical row of portal blocks (ID 90) with the name of the map the portal should lead too. It does not matter on which line, but put the name in [] like this: [exampleWorld]
   
   
   Configuration guide

• debugging: true/false
  • This is very useful if you want to either debug errors or just see what happens behind the scenes
    
    
• useBuildInChat: true/false
  • Do you want to use the native Minecraft chat system, your own or (if set to true) use AdvenTours chat manager
    
    
• logChatMessages: true/false
  • If set to true, a file will be created in plugins/AdvenTour/chat where all chat messages will be logged to
    
    
• enableResetCommand: true/false
  • If set to true, players will be able to /reset their version of a adventure map. A reset is done be unloading, deleting and reloading a world
    
    
• maxUseOfResetCommand: #
  • This is self explanatory, but if you don't want users to spam /reset to create load, set this low or disable resets in the above setting
    
    
• usePortals: true/false
  • This disables the use of portal blocks (ID 90) and limits you to enter worlds by commands
    
    
• logFileSize: #
  • Self explanatory. Number is defined in bytes
    
    
• playerAfkTime: #
  • Self explanatory. Number is defined in minutes
    
    
• playerTimeQuestionMin: #
  • Defined in minutes. This feature has been added to prevent bots. Just use a high number if you want to disable this
    
    
• playerTimeQuestionAnswerMin: #
  • How long a player has to answer the above question before he gets kicked to the lobby
    
    
• worldInvitationTimeLimit: #
  • Defined in minutes. Defines the time in which an invited player has to join the hosts map. This is added to prevent multiple invitations at once
    
    
• worldRequestTimeLimit: #
  • Defined in minutes. This number defines the time that has to pass between the host being able to invite another player to his/hers world
    
    
• worldPositionSave: #
  • Coming soon!
    
    
• maxWorlds: #
  • Self explanatory. Remember to include your main world, Nether and End if those are enabled. (Always set this to a minimum of 2 for main world + 1 adventure map)
    
    
• lobby: NameOfMainWorld
  • Self explanatory
    
    
• worlds:
  • Replace Testworld1 and Testworld2 (and add more) with the names of your adventure maps. Names can be up to 13 chars long.
    
    
• donotunload: NameOfWorld
  • Worlds defined here will not unload when the last player leaves (main world, Nehter and End do not unload even if not defined)