Bukkit

FAQ

Setup

Q:Why does it say I don't have permission to use the '/cat' commands?

• If you are not using a permissions plugin then check you have given yourself "Op" status by adding your name to the file "ops.txt"

Q:How do I control the permission system Catacomb is using?

• When Catacombs starts up you'll get a message in the server console saying which permission system it's found (or more accurately which system WEPIF has found). The messages will look something like this:

10:34:08 [INFO] [Catacombs] Enabling Catacombs <version>
10:34:08 [INFO] [Catacombs] Using WEPIF to find permissions plugin
10:34:08 [INFO] [Catacombs] No permissions plugin found, will use player's Op flag
or
10:42:23 [INFO] [Catacombs] WEPIF: PermissionsEx detected! Using PermissionsEx for permissions.
or
10:44:26 [INFO] [Catacombs] WEPIF: Using the Bukkit Permissions API.

Bukkit/Minecraft have 2 built in permissions systems. Firstly the Bukkit Permissions API which many people don't even know that they have installed.If you are not using this you should disable it in the 'wepif.yml' file in your main server directory (not the plugins directory). Secondly there is Operator status which gives Op status to the players named in ops.txt (again in the server directory). It's this second mechanism that bukkit uses if it can't find a permissions plugin.

Here is a table showing what the different permissions system are called in the wepif.yml file. Edit the wepif.yml file and move the resolver name for the permissions system you want to use into the 'enabled' section and any you have installed but don't want to use into the 'disabled' section.

Q:I'm Op on my server why does it say I don't have permission for the '/cat' commands?

• Check DinnerPermsResolver is in the list of disabled plugins in your 'wepif.yml' file in the main server directory (not the plugins directory), or read up on the Bukkit API permissions mechanism and set up the permissions correctly.

resolvers:
    enabled:
    - PluginPermissionsResolver
    - PermissionsExResolver
    - bPermissionsResolver
    - FlatFilePermissionsResolver
    - NijiPermissionsResolver
    disabled:
    - DinnerPermsResolver

Q:I'm trying to use PermissionsBukkit/bukkit permissions API with Catacombs. Why doesn't Catacombs detect and use it?

• The permissions system is selected via the wepif.yml file in the main server directory (not the plugins directory). Move the 'DinnerPermsResolver' into the enabled section if you want to setup and use Bukkit permissions.

resolvers:
    enabled:
    - DinnerPermsResolver
    - PluginPermissionsResolver
    - PermissionsExResolver
    - bPermissionsResolver
    - FlatFilePermissionsResolver
    - NijiPermissionsResolver
    disabled:

• The code will auto select between the systems available listed in the enabled section in order. Move any permissions systems you have installed and don't want it to use into the disabled section.

• The bukkit permissions system is deliberately off by default when Catacombs builds the wepif.yml file, because it comes built into bukkit and many people don't even know they've got it, they haven't configured it, and want to use ops.txt instead (i.e if Catacombs builds wepif.yml then the default is set to work well with the simplest servers and people who want Bukkit permissions system will need to change the wepif.yml file).

Debug

Q:Why isn't such-n-such a feature working in Catacombs?

• Make sure it's a Catacombs problem before posting. Briefly turn off all other plugins (by moving the other .jar files to a temporary directory) to confirm the problem is with Catacombs.
• Read the Commands page to confirm the expected behaviour.
• If there is a stack trace in the server console that has been generated by Catacombs save it for me so the issue can be tracked down.
• If you get a null pointer exception in your game window and no other clues in the server console you'll need to describe (in detail) exactly what you did to generate it.

Building

Q:How do I control the blocks that my dungeon is built from?

• There are 4 options in the config file that control the "major" (walls), roof, floor blocks and the "minor" block which is scattered randomly and included in the secret doors. The name that you use must be the bukkit name for the block, the full list of names can be found here Material. Upper or lower case as both accepted. You can also select between the different style of certain blocks by adding a ":" and a data byte value (see the example below which selects the mossy smooth brick block for the minor block).

catacomb:
  Block:
    Major: smooth_brick
    Minor: smooth_brick:1
    Floor: smooth_brick
    Roof: smooth_brick

Q:Why does '/cat plan mydungeon 2 20' say the dungeon is incomplete and can't be built?

• This usually means the planner can't find enough natural space beneath your feet to build the dungeon, or that the dungeon got a bit too full and no location for the final room could be found. Try again or move to a new location and try again.

Q:How do I build dungeons down through open sky?

• Add 'air' to the list of natural blocks in the config.yml file.

Q:How do I stop my chests containing item X?

• Edit the config file and make sure item X doesn't appear in any of the Small, Medium or Big loot lists.
• If you don't want ore that was displaced during the dungeon build appearing in the end of level (medium) chests then set SweepOre to false in the config.yml.
• Small, Medium and Big chests also have a chance of leather, iron, gold or diamond equipment, this is controlled by LeatherEquipPct, or the two EquipPct attributes. Set them to '0' to disable this extra loot. Note that Medium and Big chests also contain Small chest loot.

Q:How do I remove the brewing table in the 'Hut' on top of the dungeon?

• Use the config file to select a simpler hut type ('small' works quite well for this).

catacomb:
  Hut:
    Type: small

Reset/Delete

Q:Why don't destroyed spawners/webs/mushrooms re-appear when a dungeon is reset?

• The reset is quite gentle (it just refills the chests, removes the torches, restores the cake and closes the door). This was originally so you can customize the dungeon without loosing your changes when the dungeon is reset. A more forceful rebuild command is on the to do list.

Q:Why do I get an error when I try and change the block my dungeon is built from?

• Check you have used the bukkit names for the blocks (or the ID numbers) listed here http://jd.bukkit.org/doxygen/d9/db0/Material_8java_source.html

Exploring

Q:Why can't I place torches inside my dungeon?

• Check the region isn't protected by another plugin (worldguard etc). Check you didn't build the dungeon too close to a protected spawn location.

Q:Why does my multilevel dungeon come to a dead end before I've found the way down?

• Have you checked for secret doors by tapping the walls?

Q:Why don't my secret doors don't open correctly?

• Opening secret doors requires you to be able to damage the block. Check the zone isn't protected. Check you aren't in creative mode (in creative mode you may destroy the block rather than damaging it).