llamaArtv1.4

http://dev.bukkit.org/media/images/69/359/3DModel.pnghttp://dev.bukkit.org/media/images/69/309/llamaArtIcon.png

Turn your images into pixel art!



Note: This page written for B: llamaArt v1.4 for CB 1.7.2-R0.2 Feb 08, 2014



Embed Removed: https://www.youtube.com/v/ynAe6C0VW48?fs=1


Visit LtJim007 on YouTube for more great Minecraft tutorials!



If you encounter a problem or bug please submit a ticket and provide as much detail as possible. We need and appreciate your constructive feedback to help us produce a stable Release version.

Features

Easily create Pixel Art builds of your images.

  • No need to edit images before importing.
  • Supports most image formats and transparency.
  • Import from a file or URL.
  • Build in 20 different orientations.
  • Re-sizes images automatically to fit into the world for upright and diagonal orientations.
  • Customizable color-to-block palette.
  • Throttle block placement and set a RAM % threshold to control lag.
  • Option to automatically apply dithering into your artwork. (apply dithering manually)
  • Undo the last import.

    • Version 1.3 refer to this page.

ScreenShots

Commands

Command:Description:Permission:Default:Console:
/art/art [image:URL] [orientation] [dither] [invert]
The dither and invert fields are optional.
llamaart.artOPsNo
Legend: N:North, S:South, E:East, W:West, F:Flat, D:Diagonal

Orientations
Upright: N, E, S, W, NE, NW, SE, SW.
Flat: NEF, NWF, SEF, SWF.
Diagonal: NDE, NDW, EDN, EDS, SDE, SDW, WDN, WDS.
/art status
List the status of the configuration.
/art throttle #
Throttles block placement '# blocks-per-tick' (minimum of 1).
default is 20
/art threshold #
Utilization threshold that will limit to '1 blocks-per-tick' when RAM falls below threshold %. It will increase back to set throttle once % of RAM is available (between 2 and 100).
default is 80
/art list
List the image files in the plugin directory.
/art toggle check
Toggles checking for pixel conflicts. A pixel conflict is a pixel that cannot be matched to a color in the palette.
off
/art toggle palette
Toggles if the color palette should be applied to the image. Turn palette off if you want to apply it yourself. This can sometimes produce a better image quality.
Click here for a tutorial on applying the palette manually.
on
/art toggle transparent
Toggles removing of existing blocks in the transparent areas of the pixel art.
on
/art undo
UN-does the last import.
/art log
Logs a list of pixel conflicts detected in the last loaded image to PixelConflicts.html in the plugins\llamaArt folder.


Usage Examples

/art myimage.png n
Builds myimage.png upright and to the North.
/art myimage.jpg s dither
Builds myimage.jpg upright and to the South with dithering.
/art throttle 2
Sets the maximum blocks that can be placed per tick to 2.
/art threshold 95
If RAM falls below 95%, throttle block placement until RAM is above 95%.
/art http://oooorgle.com/images/FreeDomainRadio.png wdn dither
Builds FreeDomainRadio.png to the West and diagonally up to the North, with dithering.
/art myimage.bmp nw invert dither
Builds myimage.bmp to the North-West, inverted with dithering.
/art myimage.png ndw dither
Builds myimage.bmp to the North and diagonally up to the West, with dithering.
/art http://oooorgle.com/images/FreeDomainRadio.png se invert
Builds FreeDomainRadio.png to the South-East and inverted.

Configuration

  1. Copy the .jar to your plugins folder.
  2. Restart your server.
  3. Copy the images you want to import to the plugins\llamaArt folder. Images are case-sensitive. No spaces in the image file names.
  4. Add the permission 'llamaart.art' to those you wish to be able to use the /art command. We recommend OPs only. (Ops have access by default)

    Optionally:
  • You can disable Automatic Updates for this plugin by changing Auto-Update to false in the plugins/llamaArt/config.yml.
  • You can edit the color palette and create new pixel-to-block translations, Learn more.

Statistics

This plugin contains MCStats, which will collect basic information about your server. Click here to learn more.

http://api.mcstats.org/signature/llamaArt.png



Support

For support and bug reporting please use the BukkitDev ticket system.

Known Caveats

  • Too large of imports can cause lag.
  • Imports on the Flat orientation and Diagonal, mostly and especially when raised up into the air can cause an enormous load on resources, even to the point of crashing the server. It is advised that you throttle block placement to just a few, and then work your way up from there for these orientations. On the flip-side I have been able to run upright imports at a throttle of 100+ without any problems. You will just have to test and see what your system can handle.
  • As it does not resize imports on the Flat orientation to allow original image sizes of larger proportions, very large imports can extend beyond memory limits very quickly. It is advised to not import large images on the Flat orientation to begin with. Start with something small. Test and see what your system can handle if you want to build that large.
  • Servers using JRE6 may not be able to use this version until they upgrade to JRE7.
    If you are getting the 'Unsupported major.minor version 51.0' error, you need to update your java.

To-Do

Suggestions for improvements and additions to the next build are welcome in the comments.

Source Code

Not yet but, <3 CopyHeart <3

Other Plugins by this Author

llama - A collection of useful commands for both players and staff.
llamaGrapple - A simple yet configurable grapple hook.