Skip to content

Home

Jump to bottom Edit New page
tastybento edited this page Jan 30, 2018 · 1 revision

A SkyBlock

Maven repository

Check the [repo](http://dl.bintray.com/tastybento/maven-repo/com/wasteofplastic/askyblock/) for the latest version. It’ll be different to this one.

<dependency>
  <groupId>com.wasteofplastic</groupId>
  <artifactId>askyblock</artifactId>
  # For the version, use the latest version available
  <version>3.0.8.2</version>
</dependency>

<repository>
  <id>bintray-tastybento-maven-repo</id>
  <name>bintray</name>
  <url>http://dl.bintray.com/tastybento/maven-repo</url>
</repository>

Story

You find yourself marooned on an island in the sky with just a cow and a chest of strange items. Don’t fall! Moo!

Features

Set Up and Installation

Required Plugins

Recommended Plugins

  • An economy of some kind, e.g. Essentials, etc. - if you have more than one world, run a multi-world economy like Miconomy or use MultiWorldMoney

  • Essentials Spawn so you can set the spawn position

  • MultiverseCore - so you can manage multiple worlds

  • QuickShop or some kind of chest shop plugin to enable players to trade - which is a major point of this game

  • MultiInv to manage inventories and keep them separate between worlds

  • PermissionsEx to manage groups and permissions

  • MultiWorldMoney to keep money separate among worlds

  • [Greenhouses](http://dev.bukkit.org/bukkit-plugins/greenhouses/) - enables players to build biome greenhouses for biome farming!

Installation and Configuration

For upgrading, see release notes.

  1. Download the plugin (ASkyBlock.jar) and Vault plugin.

  2. Place into your plugins folder

  3. Restart your server - this will make the config.yml file

  4. Stop the server

  5. Open the plugin/ASkyBlock folder.

  6. Open up config.yml and adjust how you like.

  7. Start your server again

  8. Log in and type /island to start your island

(The next steps are optional) . Check challenges.yml and change if you like. . Set up your spawn if you’d like to use ASkyblock spawn. Go to a location quite far from other islands and type /asadmin setspawn. Then create an island spawn in that location.

Admin Tips

Some recommendations to improve game play and reduce lag:

  • Limit hoppers! They cause a lot of lag. Use config.yml settings to keep hoppers to a minimum. Do not give extra hoppers to donors. Hoppers are the #1 cause of lag!

  • Install a trading or chest shop plugin because going from one island to another is part of the fun!

  • Consider allowing creeper explosions and Enderman griefing. Some of the best servers have this on and are hard, but fun.

  • Note: A Skyblock has island protection options, including explosion prevention.

  • Make a spawn. (Convert an island to a spawn point using /asadmin setspawn)

Commands

Player Commands

A Skyblock accepts the following commands that can be /island, /as or /is:

  • /island - generates a new island or teleports the player to their island, home location or the team island (Note this can also be set to open up the control panel GUI instead)

  • /island go - teleports to the island

  • /island help - shows help text

  • /island cp or controlpanel - shows a GUI with useful commands so players do not have to type

  • /island reset or restart - restarts an island. There is a cool down timer and limits on this so that players do not abuse it.

  • /island level - ranks the island.

  • /island level <player> - shows the island rank for another player

  • /island top - shows the Top 10 islands by rank

  • /island minishop or ms - displays a shop GUI with different items - admins can customize the contents and prices

  • /island warps - Lists warps that are available via Welcome Warp Signs

  • /island warp <name> - warps to a Welcome Warp Sign. The full name does not have to by typed in (just the first few letters)

  • /island biomes - opens up the biomes GUI

  • /island lock - locks/unlocks an island so visitors cannot enter it.

Team-related Commands

  • /island invite - Invite a player to join your team. You can only invite one person at a time.

  • /island accept or reject - Accepts or rejects an invite. If a player has an island already and accepts, the island will be deleted.

  • /island team - lists info on the team

  • /island leave - leave the team - returns to spawn

  • /island kick <name> or remove <name> - only available for the island owner or leader - removes a team member. If the player is online, all their inventory will drop and they will be sent to spawn. If they are offline, they will get a message when they log in that they have been kicked.

  • /island makeleader <name> - Transfers ownership to a team member. Can only be issued by the leader.

Coop Commands

  • /island coop <player> - Give a player coop status (full access) to your island until you leave or expel them.

  • /island expel <player> - Force a player from your island, and remove their coop status if they have it

Challenges Commands

/asc, /c, /challenge or /challenges access challenge commands

  • /challenge - Shows the GUI for challenges available to the player.

  • /challenge complete or c - attempts to complete a challenge, or just click in the GUI

Admin Commands

Access via /asadmin command:

Console And Game Available Commands

  • /is level <player> - forces a level calculation of a player’s island - must be Op.

  • /asadmin reload - reloads all the configuration files. Use this if you have edited the .yml files.

  • /asadmin delete <player> - deletes a player’s island. 100% permanent, no undo - warning

  • /asadmin completechallenge <challengename> <player> - completes an individual challenge for a player

  • /asadmin resetchallenge <challengename> <player> - resets a challenge for a player

  • /asadmin resetallchallenges <player> - clears all challenges for a player

  • /asadmin purge [TimeInDays] - warning very dangerous command. Will remove all old/unused islands where the player has not logged in for X number of days. Strongly recommend you back up the world first and run when no players are online.

  • /asadmin info <player> - Displays a lot of info on a player, including their challenge completion status, their island bedrock location, etc.

  • /asadmin topten - Regenerates the top ten list if it is out of sync - this runs through all player files and finds out the island levels from them. It will not recalculate island levels - this command should never need to be run. Recommend to run /is level <player> instead.

  • /asadmin unregister <player> - removes the player from the island without deleting the island blocks

Game-only command

  • /asadmin register <player> - Registers the closest island to <player>. To use, go to an island and execute the command. You should never need this command.

  • /asadmin setspawn - Converts the nearest island to a spawn point that has special rules and protections. Change spawn.yml to set them.

  • /asadmin tp <player> - teleport to a player’s island

Permissions

Regular players should typically be given the following:

  • askyblock.island.*

  • askyblock.team.create

  • askyblock.team.kick

  • askyblock.team.makeleader

  • askyblock.team.join

and if you want to use the control panel:

  • askyblock.island.controlpanel

If island protection or commands are not working check your permissions before requesting help!

Full list:

askyblock.*:
  default: false
  children:
    askyblock.island.*:
      children:
        askyblock.island.go:
          description: Allow teleporting to player island
          default: true
        askyblock.island.create:
          description: Let the player use the /island command
          default: true
        askyblock.island.info:
          description: Let the player check their island level
          default: true
        askyblock.island.topten:
          description: Let the player see the top ten list
          default: true
        askyblock.island.sethome:
          description: Let the player set their island teleport point
          default: true
        askyblock.island.challenges:
          description: Let the player use the /challenges command
          default: true
        askyblock.island.warp:
          description: Let the player use /island warp to warp to a players island
          default: true
        askyblock.island.addwarp:
          description: Let the player place a Welcome warp sign
          default: true
        askyblock.island.minishop:
          description: Allows usage of the minishop
          default: true
        askyblock.island.controlpanel:
          description: Allows usage of the island GUI
          default: true
        askyblock.island.biomes:
          description: Allows biome changing
          default: true
        askyblock.island.lock:
          description: Allows island locking
          default: false
        askyblock.island.expel:
          description: Allows expelling of visitors
          default: true
        askyblock.island.ban:
          description: Allows banning of visitors
          default: false
        askyblock.island.settings:
          description: Player can see server settings
          default: true
        askyblock.island.lang:
          description: Player can select a language
          default: true
        askyblock.island.name:
          description: Player can set the name of their island
          default: false
        askyblock.island.value:
          description: Player can see the value of a block
          default: true
        askyblock.island.spawn:
          description: Player can use the island spawn command if spawn exists
          default: true
        askyblock.island.reset:
          description: Player can use the island reset or restart command
          default: true  
    askyblock.team.*:
      children:
        askyblock.team.create:
          description: Let a player invite other players to join a team
          default: true
        askyblock.team.kick:
          description: Let a player kick other players
          default: true
        askyblock.team.makeleader:
          description: Let a player make another player leader of the team
          default: true
        askyblock.team.join:
          description: Let a player join another player's team
          default: true
        askyblock.team.chat:
          description: Allow player to use team chat
          default: true
    askyblock.command.*:
      description: Event commands will not be run for players with this perm
      default: false
      children:
        askyblock.command.resetexempt:
          description: Player is exempt from commands run when island resets
          default: false
        askyblock.command.leaveexempt:
          description: Player is exempt from commands run when they leave or are kicked. Note will not help if player is offline.
          default: false
        askyblock.command.newexempt:
          description: Player is exempt from commands run when starting an island
          default: false
        askyblock.command.challengeexempt:
          description: Player is exempt from commands run when a challenge is completed
          default: false
        askyblock.command.newteamexempt:
          description: Player is exempt from commands run when accepting a team invite
          default: false
    askyblock.coop:
      description: Allows player to use the coop command
      default: false    
    askyblock.craft.*:
      children:
        askyblock.craft.enderchest:
          description: Allow crafting and use of enderchests in askyblock
          default: false
        askyblock.craft.dirt:
          description: Allows tilling of coarse dirt into dirt
          default: false
    askyblock.intopten:
      description: Includes player in top ten
      default: true
    askyblock.nohunger:
      description: Excludes player from hunger if on island
      default: false
    askyblock.islandfly:
      description: Allow player to fly inside his island boundaries
      default: false
    askyblock.settings.*:
      description: Ability to change settings in GUI
      default: false
      children:
        askyblock.settings.ACID_DAMAGE:
          description: Can configure the Acid Damage setting
          default: false
        askyblock.settings.ANVIL:
          description: Can configure the Anvil setting
          default: false
        askyblock.settings.ARMOR_STAND:
          description: Can configure the Armor Stand setting
          default: false
        askyblock.settings.BEACON:
          description: Can configure the Beacon setting
          default: false
        askyblock.settings.BED:
          description: Can configure the Bed setting
          default: false
        askyblock.settings.BREAK_BLOCKS:
          description: Can configure the Break Blocks setting
          default: false
        askyblock.settings.BREEDING:
          description: Can configure the Breeding setting
          default: false
        askyblock.settings.BREWING:
          description: Can configure the Brewing setting
          default: false
        askyblock.settings.BUCKET:
          description: Can configure the Bucket setting
          default: false
        askyblock.settings.COLLECT_LAVA:
          description: Can configure the Collect Lava setting
          default: false
        askyblock.settings.COLLECT_WATER:
          description: Can configure the Collect Water setting
          default: false
        askyblock.settings.CHEST:
          description: Can configure the Chest setting
          default: false
        askyblock.settings.CHORUS_FRUIT:
          description: Can configure the Chorus Fruit setting
          default: false
        askyblock.settings.CRAFTING:
          description: Can configure the Crafting setting
          default: false
        askyblock.settings.CREEPER_PAIN:
          description: Can configure the Creeper Pain setting
          default: false
        askyblock.settings.CROP_TRAMPLE:
          description: Can configure the Crop Trample setting
          default: false
        askyblock.settings.DOOR:
          description: Can configure the Door setting
          default: false
        askyblock.settings.EGGS:
          description: Can configure the Eggs setting
          default: false
        askyblock.settings.ENCHANTING:
          description: Can configure the Enchanting setting
          default: false
        askyblock.settings.ENDER_PEARL:
          description: Can configure the Ender Pearl setting
          default: false
        askyblock.settings.ENTER_EXIT_MESSAGES:
          description: Can configure the Enter Exit Messages setting
          default: false
        askyblock.settings.FIRE:
          description: Can configure the Fire setting
          default: false
        askyblock.settings.FIRE_EXTINGUISH:
          description: Can configure the Fire Extinguish setting
          default: false
        askyblock.settings.FIRE_SPREAD:
          description: Can configure the Fire Spread setting
          default: false
        askyblock.settings.FURNACE:
          description: Can configure the Furnace setting
          default: false
        askyblock.settings.GATE:
          description: Can configure the Gate setting
          default: false
        askyblock.settings.HORSE_INVENTORY:
          description: Can configure the Horse Inventory setting
          default: false
        askyblock.settings.HORSE_RIDING:
          description: Can configure the Horse Riding setting
          default: false
        askyblock.settings.HURT_MOBS:
          description: Can configure the Hurt Mobs setting
          default: false
        askyblock.settings.HURT_MONSTERS:
          description: Can configure the Hurt Monsters setting
          default: false
        askyblock.settings.LEASH:
          description: Can configure the Leash setting
          default: false
        askyblock.settings.LEVER_BUTTON:
          description: Can configure the Lever Button setting
          default: false
        askyblock.settings.MILKING:
          description: Can configure the Milking setting
          default: false
        askyblock.settings.MOB_SPAWN:
          description: Can configure the Mob Spawn setting
          default: false
        askyblock.settings.MONSTER_SPAWN:
          description: Can configure the Monster Spawn setting
          default: false
        askyblock.settings.MUSIC:
          description: Can configure the Music setting
          default: false
        askyblock.settings.NETHER_PVP:
          description: Can configure the Nether Pvp setting
          default: false
        askyblock.settings.PLACE_BLOCKS:
          description: Can configure the Place Blocks setting
          default: false
        askyblock.settings.PORTAL:
          description: Can configure the Portal setting
          default: false
        askyblock.settings.PRESSURE_PLATE:
          description: Can configure the Pressure Plate setting
          default: false
        askyblock.settings.PVP:
          description: Can configure the Pvp setting
          default: false
        askyblock.settings.REDSTONE:
          description: Can configure the Redstone setting
          default: false
        askyblock.settings.SPAWN_EGGS:
          description: Can configure the Spawn Eggs setting
          default: false
        askyblock.settings.SHEARING:
          description: Can configure the Shearing setting
          default: false
        askyblock.settings.VILLAGER_TRADING:
          description: Can configure the Villager Trading setting
          default: false
        askyblock.settings.VISITOR_ITEM_DROP:
          description: Can configure the Visitor Item Drop setting
          default: false
        askyblock.settings.VISITOR_ITEM_PICKUP:
          description: Can configure the Visitor Item Pickup setting
          default: false
    askyblock.mod.*:
      children:
        askyblock.mod.topten:
          description: Let a moderator update the top ten list
          default: op
        askyblock.mod.info:
          description: Let a moderator see info on a player
          default: op
        askyblock.mod.challenges:
          description: Let a moderator access challenge commands 
          default: op
        askyblock.mod.noburn:
          description: Gives mod immunity to acid
          default: false
        askyblock.mod.resethome:
          description: Allows setting or reseting of a player's home position
          default: op
        askyblock.mod.clearreset:
          description: Allow clearing of island reset limit
          default: false
        askyblock.mod.tp:
          description: Allows teleport to an island
          default: op
        askyblock.mod.tpnether:
          description: Allows teleport to a nether island
          default: op
        askyblock.mod.bypassprotect:
          description: Allow moderator to bypass island protection
          default: op
        askyblock.mod.bypassexpel:
          description: Allow moderator to bypass island expulsion
          default: op
        askyblock.mod.setbiome:
          description: Allows setting player island biomes
          default: op
        askyblock.mod.topbreeders:
          description: Lists most populated islands current loaded
          default: op
        askyblock.mod.lock:
          description: Locks or unlocks an island
          default: op
        askyblock.mod.bypasslock:
          description: Bypasses an island lock
          default: op
        askyblock.mod.signadmin:
          description: Enables warp sign admin commands
          default: op
        askyblock.mod.spy:
          description: Spy on team chats
          default: false
        askyblock.mod.removesign:
          description: Gives ability to remove warp signs
          default: false
        askyblock.mod.team:
          description: Enables modification of teams via kick and add commands
          default: false
        askyblock.mod.name:
          description: Enables naming of player's islands
          default: false
        askyblock.mod.resetname:
          description: Enables reset of player's island names
          default: false
        askyblock.mod.setdeaths:
          description: Sets how many deaths the player has
          default: false
    askyblock.admin.*:
      children:
        askyblock.admin.clearresetall:
          description: Allow clearing of island reset limit of all players
          default: op
        askyblock.admin.reload:
          description: Reload the config.yml
          default: op
        askyblock.admin.delete:
          description: Let a player completely remove a player (including island)
          default: op
        askyblock.admin.deleteisland:
          description: Let a player completely remove the island the player is on
          default: op
        askyblock.admin.register:
          description: Let a player register the nearest island to another player.
          default: op
        askyblock.admin.unregister:
          description: Removes a player from an island without deleting the island blocks.
          default: op
        askyblock.admin.purge:
          description: Let a player purge old islands.
          default: op
        askyblock.admin.noburn:
          description: Gives admin immunity to acid
          default: false
        askyblock.admin.setspawn:
          description: Allows use of spawn tools
          default: op
        askyblock.admin.setrange:
          description: Allows setting of island protection range
          default: op
        askyblock.admin.topbreeders:
          description: Lists most populated islands current loaded
          default: op
        askyblock.admin.reserve:
          description: Reserves an empty spot for a player's next island
          default: op
        askyblock.admin.settingsreset:
          description: Resets all the islands to default protection settings
          default: op
        askyblock.admin.noban:
          description: Player cannot be banned from an island
          default: op
        askyblock.admin.cobblestats:
          description: Displays magic cobble gen stats
          default: op
        askyblock.admin.setlanguage:
          description: Resets all player languages and sets the default language
          default: op

Welcome Warp Signs

Welcome Warp Signs are an easy way for players to make warps. Each player can generate only one warp. They create a warp by placing a sign with the first line [WELCOME] on it. If the warp creation is successful, that line will become green. If there is a problem, it will become red.

[If you want Welcome Warp Signs for other worlds or just as a stand alone plugin - [download it here](http://dev.bukkit.org/bukkit-plugins/welcome-warp-signs/)]

Warps are listed under /island warps and are the player’s name. Players can warp by typing /island warp <name of warp>.

To destroy or remove a warp, the player should destroy or remove the sign.

The other lines on the sign can say anything the player wants.

The safety of a warp is checked to a certain extent, but it’s possible for players to create traps with warp signs. This may or may not be okay with the server admin, but can be interpreted as being part of the game.

Developer API

To Do

ASkyBlock is in maintenance mode and new features are now going onto BSkyBlock.

Add a custom footer
Add a custom sidebar
Clone this wiki locally