KImageTerrain 1.0

Tested Minecraft Versions:

• 1.7
• 1.8
• 1.9

KImageTerrain
The idea is very simple - using this plugin you can turn images like this:

Spoiler

Into terrain and biomes like this:

Spoiler

Configuration:

Code (YAML):

# Config version, do not change it manually!
configVersion: 1

# Security password used to authorize task start
# Do not leave the default password, change it immediately!
securityPassword: changeMeNow!

# How many columns will be changed at once?
# This setting applies to TERRAIN tasks
terrainChangeAtOnce: 1000

# How many columns will be changed at once?
# This setting applies to BIOME tasks
biomeChangeAtOnce: 20000

# Delay between changes, given in ticks
# 1 second = 20 ticks
intervalBetweenChanges: 40

# Do you want to allow usage of alpha (transparency) in your schemes?
# This will increase possible colors from 16.777.216 to 4.294.967.296
# BUT, it will also require giving 4th color part in the schemes (r,g,b,alpha)
# If you don't give that part - this setting is almost useless
useAlpha: false

# Do you want to always place a bedrock block at y=0?
# If this setting is set to true, the plugin will omit checking what block do you want to place at y=0
alwaysPlaceBedrock: true

# Do you want to clear all blocks, which were not defined in the scheme?
airIfNull: true

# Do you want to resume saved tasks on server startup?
# If this is set to false and there are saved tasks - they are simply deleted and forgotten
resumeSavedTasks: true

# Do you want to broadcast a message if a task has started/finished?
broadcastTask: true

# Default scheme for TERRAIN task, used when there is no scheme for a given color
# Correct syntax: color [email protected] materialName:[email protected] ...
defaultIfTerrainNull: [email protected] [email protected]

# Default scheme for BIOME task, used when there is no scheme for a given color
# Correct syntax: biomeName
defaultIfBiomeNull: PLAINS
 
# Default scheme for TERRAIN task, which can be used by all tasks
# Correct syntax: color [email protected] materialName:[email protected] ...
# Color syntax: red,green,blue,alpha (alpha will be omitted if useAlpha is set to false)
# In default config there are additional comments in this section to ease reading
universalTerrainScheme:
# Sand
- 255,255,0 [email protected] [email protected]
# Grass
- 0,255,0 [email protected] [email protected]
- 0,240,0 [email protected] [email protected]
- 0,225,0 [email protected] [email protected]
- 0,210,0 [email protected] [email protected]
- 0,195,0 [email protected] [email protected]
- 0,180,0 [email protected] [email protected]
- 0,165,0 [email protected] [email protected]
- 0,150,0 [email protected] [email protected]
- 0,135,0 [email protected] [email protected]
# Water
- 0,0,255 [email protected] [email protected] [email protected]
- 0,0,200 [email protected] [email protected] [email protected]
- 0,0,150 [email protected] [email protected] [email protected]
- 0,0,140 [email protected] [email protected] [email protected]
- 0,0,110 [email protected] [email protected] [email protected]
- 0,0,85 [email protected] [email protected] [email protected]
- 0,0,65 [email protected] [email protected] [email protected]
- 0,0,50 [email protected] [email protected] [email protected]
# Clear
- 0,0,0 [email protected] [email protected]

# Default scheme for BIOME task, which can be used by all tasks
# Correct syntax: color biomeName
# Color syntax: red,green,blue,alpha (alpha will be omitted if useAlpha is set to false)
universalBiomeScheme:
- 255,255,0 DESERT
- 0,255,0 MUSHROOM_ISLAND
- 0,0,255 RIVER

Plugin usage:

• 
  
  
  • All images and 'own scheme files' must be in the images folder
  • All images must have .png extension
  • Don't touch savedData.yml file, it will be managed automatically
  • Before asking any questions - read the whole plugin page and see the video tutorial!

Own scheme files:

1. 
   
   
   • In the images folder create a file with the same name, as the image has, but with .yml extension
   • In that file create sections: terrainScheme and biomeScheme
   • This sections should be lists of schemes, individual schemes must be created with the same rules, as those in the config file

Example file blank.yml (made for blank.png image)

Spoiler: blank.yml

Code (YAML):

terrainScheme:
# Sand
- 255,255,0 [email protected] [email protected]
# Grass
- 0,255,0 [email protected] [email protected]
- 0,240,0 [email protected] [email protected]
- 0,225,0 [email protected] [email protected]
- 0,210,0 [email protected] [email protected]
- 0,195,0 [email protected] [email protected]
- 0,180,0 [email protected] [email protected]
- 0,165,0 [email protected] [email protected]
- 0,150,0 [email protected] [email protected]
- 0,135,0 [email protected] [email protected]
# Water
- 0,0,255 [email protected] [email protected] [email protected]
- 0,0,200 [email protected] [email protected] [email protected]
- 0,0,150 [email protected] [email protected] [email protected]
- 0,0,140 [email protected] [email protected] [email protected]
- 0,0,110 [email protected] [email protected] [email protected]
- 0,0,85 [email protected] [email protected] [email protected]
- 0,0,65 [email protected] [email protected] [email protected]
- 0,0,50 [email protected] [email protected] [email protected]
# Clear
- 0,0,0 [email protected] [email protected]

biomeScheme:
- 255,255,0 DESERT
- 0,255,0 MUSHROOM_ISLAND
- 0,0,255 RIVER

Commands:

• /kterrain <arguments> - Main plugin command
• /kterrain help - Shows plugin help
• /kterrain args - Shows all possible /kterrain command arguments
• /kterrain images - Shows what images can be used by the plugin
• /kterrain check <arguments> - Checks if all image's pixels colors are configured
• /kterrain tasks - Shows all running tasks
• /kterrain task <taskID> <-t/-s/-ts> - Terminates/saves/terminates and saves a task with a given ID
• /kterrain accept <securityPassword> - Finishes and accepts task creation

Permissions:

• kimageterrain.notify - Allows to see, when someone uses wrong securityPassword
• To use /kterrain command you have to be an OP

English video tutorial:


ToDo:

• Add configurable messages
• Do you have any ideas? Send them to me via review/pm/discussion

Source code:

​

MCStats:

​