Skip to content

garet90/simple-skyblock

Repository files navigation

SimpleSkyblock Build Status

Description

A simple Skyblock. Includes all the essentials, such as land protection, island generation, co-op, and more, along with some optional extras such as Economy, Trading, Island Chat Channels and more, all of which can be disabled for maximum customization.

Commands

  • /island: Main command. Includes sub-commands such as /is help, /is visit [player], /is reset, /is home, /is sethome, /is settings (you can disable island visiting here)
  • /balance: Shows how much money a player has
  • /pay : Pay a player some money
  • /fly: Enable / disable flying
  • /trade : Trade with a player
  • /shout : Shout to the whole server.

Permissions:

  • skyblock.island: includes all /island commands and subcommands
  • skyblock.economy: includes /balance and /pay commands
  • skyblock.fly: includes /fly command
  • skyblock.shout: includes /shout commands
  • skyblock.trade: includes /trade commands
  • skyblock.admin: allows admin control of skyblock plugin (such as /is allowreset)

Installation:

Plop it into your plugins folder, then after first run you will be able to edit the config.yml to your liking. If you would like the Skyblock world to be your default world (the "level-name" declared in server.properties) you will need to add the following to "bukkit.yml"

worlds:
  world:
    generator: SimpleSkyblock
  world_nether:
    generator: SimpleSkyblock

If you want it to be a separate world, there is no need to add this to the bukkit.yml, and this will be handled for you automagically. You do not need a plugin like Multiverse, the world will be generated and players can travel to it without it. Plugins like Multiverse can still be used, just make sure to set the generator to SimpleSkyblock. Pay special attention when editing config.yml, because some of the settings require specific values or they wont work, like "BIOME". A list of all the settings and their descriptions are listed below.

config.yml

# Welcome to the configuration of SimpleSkyblock!
# Below are some of the customizable parts of
# SimpleSkyblock! If you need something special, feel
# free to send me an email at themanhimself@garet.holiday



# +-------------------------------------------+
# |       WORLD GENERATION / MANAGEMENT       |
# +-------------------------------------------+

# SimpleSkyblock is equipped with a world generator which
# will generate a blank world with no blocks. To use it,
# simply add the following to bukkit.yml:
# worlds:
#   [world name]:
#     generator: SimpleSkyblock

# To change the biome of the world generated, edit the
# following line.
BIOME: PLAINS

# To change the name of the world which all skyblock islands
# will generate, edit the line below. If the world doesn't
# exist, we'll create a new one for you using SimpleSkyblock's
# empty world generator.
WORLD: world

# The height at which the islands will generate. This is the Y
# value at which the bedrock block will be.
ISLAND_HEIGHT: 70

# The width of the claimed island plot. Changing this will
# change the size of the claimed island plot in the X
# direction. The negative-most block in the X will be half an
# island width away from the island border. Islands will, by
# default, have 1 block of no-man's land between them.
ISLAND_WIDTH: 5000

# Island depth is the same as island width, but in the Z
# direction.
ISLAND_DEPTH: 5000

# The limits are how far SimpleSkyblock is allowed to generate
# islands. The islands will generate in the following pattern:
# The first island will generate at -LIMIT_X, -LIMIT_Z. Every
# time a new island is generated, it will add an ISLAND_WIDTH
# to the X value, until it hits LIMIT_X, after which it will
# go back to -LIMIT_X and increment Z by one ISLAND_DEPTH.
LIMIT_X: 29990000

# LIMIT_Z is the limit in which islands can generate in the
# SimpleSkyblock world.
LIMIT_Z: 29990000

# The settings listed above allow for 35,976,004 islands, a
# number I'd be suprised if you hit



# +------------------------------+
# |       GENERAL SETTINGS       |
# +------------------------------+

# CHAT_PREFIX is the "name tag" for SimpleSkyblock when it
# is speaking in the chat. Use '&' for color codes.
CHAT_PREFIX: '&7[&bSKYBLOCK&7] &r'

# VOID_INSTANT_DEATH toggles if players die instantly in the
# void instead of slowly losing health.
VOID_INSTANT_DEATH: true

# VOID_INSTAND_DEATH_WORLDS defines which worlds to have
# players instantly die in the void. Using * will apply
# void instant death to all worlds.
VOID_INSTANT_DEATH_WORLDS:
- '*'

# DISABLE_PLAYER_COLLISIONS toggles player collisions. This
# is active for the skyworld and the nether counterpart
# only. (a change from previous versions)
DISABLE_PLAYER_COLLISIONS: true

# USE_CHATROOMS defines whether to use SimpleSkyblock's
# chatrooms. They create seperate channels for each island,
# and allow only players with skyblock.shout permission to
# talk to the whole server using /shout. When this is
# disabled, the server goes back to default chatting or
# lets another plugin take over.
USE_CHATROOMS: false

# CHAT_WORLDS defines which worlds to use SimpleSkyblock's
# chatrooms in. Using * will use the chatrooms for all
# worlds.
CHAT_WORLDS:
- '*'

# INFINITE_RESETS defines whether players can reset their
# islands as much as they want. This can be exploited, so
# island resets are generally limited. An operator can
# allow an island reset by using /is allowreset <player>
INFINITE_RESETS: false

# If INFINITE_RESETS is false, RESET_COUNT is how many
# times the player will be able to reset their island.
RESET_COUNT: 3

# RESET_COST is the cost of each reset. This can be
# enabled or set to false. Enabling it would look like
# the following:
# RESET_COST:
# - 30
# - 40
# - 50
# Enabling RESET_COST will allow players to keep money
# accross resets.
RESET_COST: false

# Enabling RETAIN_MONEY will have users keep their money
# after resetting or generating a new island.
RETAIN_MONEY: false

# USE_NETHER determines whether to allow players to have a
# nether island.
USE_NETHER: true

# ISLAND_TYPES defines which types of islands players can
# choose to start out with.
ISLAND_TYPES: 
  default: 
    cost: 0
    item: GRASS_BLOCK
    lore: 
      - "&r&7The default island."
      - "&r&7Has a chest, a tree, and some dirt."
    # The item, name, and lore are only needed if you
    # have multiple for the GUI
    
    # The nether schematic will be named "name_nether", so
    # default's nether schematic is default_nether in the
    # structures folder
    name: "&2Default"
    permission: skyblock.island
    # Not needed, just to show how you would require a
    # permission to use an island type
    schematic: default
#   structures:
#     # An example of how to add extra structures
#     desert:
#       # X offset
#       x: 0
#       # Z offset
#       z: 100
#       # The schematic to use
#       schematic: desert
#       # The biome to use (optional)
#       biome: desert

# snowy: 
#   cost: 500
#   item: SNOW_BLOCK
#   lore: 
#     - "&r&7Be careful, it's cold!"
#     - "&r&7Basically just snow, not gonna lie."
#   name: "&fSnowy"
#   permission: skyblock.snowy
#   schematic: snowy

# snowy is just an example of how you would add another island type

# FLIGHT_EVERYWHERE determines whether players can fly at other's
# islands, not just their own with the /fly command. Players with OP
# or skyblock.admin automatically bypass this.
FLIGHT_EVERYWHERE: false

ACHIEVEMENTS:
# getDirt:
#   requirements:
#     hasItems:
#     - DIRT:1
#     # Required items in inventory to complete achievement
#     hasMoney: 0
#     # Required money to complete achievement
#     hasPermission: skyblock.island
#     # Required permission to complete achievement
#     level: 5
#     # Required level to complete achievement
#   rewards:
#     items:
#     - DIAMOND:10
#     money: 100
#   item: DIRT
#   name: "&2Get Dirt"
#   lore:
#   - "&r&7Get some dirt"
#   - "&r&7That's about it."

# An example of how to add an achievement. Achievements are checked
# automatically and do not remove items or money upon completion,
# whereas quests do.

# ANNOUNCE_ACHIEVEMENTS determines whether or not to notify the entire
# server when a player completes a skyblock achievement.
ANNOUNCE_ACHIEVEMENTS: false

QUESTS:
# getDirt:
#   costs:
#     items:
#     - DIRT:1
#     money: 0
#     permission: skyblock.island
#     # Permission is not taken
#     level: 5
#     # level is not taken
#   rewards:
#     items:
#     - DIAMOND:10
#     money: 100
#   item: DIRT
#   name: "&2Get Dirt"
#   lore:
#   - "&r&7Get some dirt"
#   - "&r&7That's about it."

# An example of how to add a quests. Quests are checked each time
# they are clicked on in the /is quests GUI. The costs are taken and
# the rewards are added.


# +-----------------------------+
# |       ISLAND SETTINGS       |
# +-----------------------------+

# GENERATE_ORES determines whether or not to generate ores
# in the cobblestone generator instead of just cobblestone.
# Enabling this will also generate ores on the bottom of
# the island as well during island generation. This is
# only active in the skyblock world.
GENERATE_ORES: true

# GENERATOR_ORES are the ores which will be generated,
# along with the percent chance of generation. These do
# not technically need to be ores. They must be formatted
# as follows:
# [BLOCK_NAME]:[PERCENT_CHANCE]
GENERATOR_ORES:
- COAL_ORE:5
- IRON_ORE:7.5
- GOLD_ORE:.2
- DIAMOND_ORE:.2
- LAPIS_ORE:.2
- REDSTONE_ORE:1.5
- EMERALD_ORE:.1
- OBSIDIAN:.05
- STONE:42.125
- COBBLESTONE:42.125

# CHEST_ITEMS are the items that appear in the chest
# that generates on the islands. They must be formatted
# as [ITEM]:[AMOUNT]
CHEST_ITEMS:
- LAVA_BUCKET:1
- ICE:2
- SUGAR_CANE:1
- RED_MUSHROOM:1
- BROWN_MUSHROOM:1
- PUMPKIN_SEEDS:1
- MELON_SLICE:1
- CACTUS:1
- COBBLESTONE:16

# USE_TRUSTS determines whether islands can "trust"
# players to break blocks, use chests, kill mobs, etc
# without actually being a member of the island.
# Requires special permission "skyblock.trust"
USE_TRUSTS: false

# How much each point from the levelpoints.yml is
# worth in terms of levels
LEVEL_POINTS_MULTIPLIER: .01

# How much each chunk the island spans is worth when
# calculating levels
LEVEL_SPREAD_MULTIPLIER: .1

# ANIMAL_CAP is the most passive mobs an island can have
# on it at one time, as to not max out the server. This
# affects passive mob spawning and breeding. (NOTE:
# breeding cannot be bypassed on 1.9 and below)
ANIMAL_CAP: 10

UPGRADES:
# someOther:
#   item: DIRT
#   name: "Legit does nothing"
#   lore:
#   - "&r&7That's about it."
# betterGenerators:
#   costs:
#     money: 1000
#     items:
#     - DIAMOND:10
#     permission: skyblock.island
#     level: 10
#     pre:
#     - someOther
#     # pre is what must be unlocked before this one can be
#   rewards:
#     generator_ores:
#     - DIAMOND_ORE:100
#   item: FURNACE
#   name: "&2Better Generators"
#   lore:
#   - "&r&7Cobblestone generators are better"
#   - "&r&7That's about it."

# An example of how to add an upgrade. Upgrades
# apply to islands. More rewards coming soon,
# for now the only thing that can change are the
# generator ores. Similar to quests, but apply to
# islands.



# +------------------------------+
# |       ECONOMY SETTINGS       |
# +------------------------------+

# USE_ECONOMY determines whether to use the
# SimpleSkyblock economy to begin with. Changing
# this will disable all economy features.
USE_ECONOMY: true

# STARTING_MONEY is the amount of money the players
# receive when they start their islands.
STARTING_MONEY: 500.0

# KILL_MONEY is the amount of money that players
# get for the mobs which they kill. They must be
# formatted as follows:
# [MOB]:[DOLLARS]
# This additionally accepts values of 'Default',
# 'Monster', and 'Animals'.
KILL_MONEY:
- Default:0
- Monster:3
- Animals:1
- CREEPER:5
- ENDERMAN:10
- ZOMBIE:2
- SPIDER:4

# LOSS_ON_DEATH is the amount of money that
# players lose when they die. It can be 'half' or
# a number.
LOSS_ON_DEATH: half



# +--------------------------------+
# |       MECHANICS SETTINGS       |
# +--------------------------------+

# USE_CUSTOM_MECHANICS determines whether to use
# custom SimpleSkyblock mechanics, or whether to
# keep it to just the basics. Setting this to false
# will turn all below-listed mechanics settings
# off.
USE_CUSTOM_MECHANICS: true

# BLAST_PROCESSING toggles whether items can be
# blasted to create other materials. This includes
# blasting cobble to get gravel and gravel to sand,
# which were added to provide a way to get more
# dirt which requires players to be creative.
# These mechanics are removed when this is set to
# false.
BLAST_PROCESSING: true

# BONEMEAL_DOES_MORE toggles whether to use custom
# bonemeal mechanics or not. The custom mechanics
# allow for the obtaining of saplings and seeds
# through bonemealing grass, kelp and sea pickles
# through bonemealing underwater dirt, and
# bonemealing dirt to have it become grass. These
# were all added to make plants, as well as grass
# attainable (especially if grass is destroyed)
BONEMEAL_DOES_MORE: true

# COBBLE_HEATING toggles whether or not to use
# custom cobble heating mechanics which allow lava
# to be created by chance if coal blocks are burned
# underneath a cobblestone block. This was added to
# allow users to get more lava, but can be disabled
# by setting this to false.
COBBLE_HEATING: true

# SOUL_SAND determines whether enemies killed on
# sand in the skyblock nether will turn the sand
# into soul sand.
SOUL_SAND: true



# You survived! You made it through the entire
# config! Good job, now don't edit this line, or
# it might do some funky stuff.
config-version: 1.4.0