Skip to content
This repository was archived by the owner on Oct 28, 2025. It is now read-only.

Commands

Jump to bottom
SBPrime edited this page Jul 12, 2014 · 6 revisions

All commands should by in this format: /MCPainter .... All block drawing operations are done in a separate thread to minimize the lag. Each user has its own block queue. Thanks to that an active user won't interfere with other users operations. The block drawing starts from player current position, and use the player orientation. If no command name is given the help will by displayed (/mcpainter).

Back to main page

Help

Display help for the plugin.

Usage: Help [commandName]

  • commandName - The name of the command to display detailed informations

Sample:

/mcpainter help filter - Display help for filter command.

Image

This command allows the user to draw a pixel art image.

Permissions used by the command:

  • MCPainter.user.drawImage
  • MCPainter.user.size.x
  • MCPainter.admin.size.bypass

Usage: Image

  • imageurl - the url of the image to draw. Supported image formats: png, jpeg, bmp

Sample:

/MCPainter Image http://www.google.pl/images/srpr/logo3w.png - Draw pixel art from www.google.pl/images/srpr/logo3w.png.

Alias: /Image

HD Image (since 1.0-RC5)

This command allows the user to draw a image directly in the world using frames and maps

Permissions used by the command:

  • MCPainter.user.drawHdImage
  • MCPainter.user.size.x
  • MCPainter.admin.size.bypass

Usage: ImageHD

  • imageurl - the url of the image to draw. Supported image formats: png, jpeg, bmp

Warning: This command requires you to select a vertical cuboid region using WorldEdit wand.

Sample:

/MCPainter ImageHD http://www.google.pl/images/srpr/logo3w.png - Draw the www.google.pl/images/srpr/logo3w.png on maps.

ImageMap

This command allows the user to draw a image directly into the map.

Permissions:

  • MCPainter.user.drawMap

Usage:

ImageMap [mapId]

ImageMap [mapId] reset

  • mapId - optional parameter, you can specify the map Id on with you want the image to get drawn. If this parameter is not given the image will by drawn on the map currently held by the player
  • imageurl - the url of the image to draw. Supported image formats: png, jpeg, bmp

Sample:

/MCPainter ImageMap http://www.google.pl/images/srpr/logo3w.png - Draw pixel art from www.google.pl/images/srpr/logo3w.png on currently held map.

/MCPainter ImageMap 10 reset - Reset map #10 to standard minecraft map.

Alias: /Map

Block

This command allows the user to draw a minecraft block or item.

Permissions:

  • MCPainter.user.drawBlock

Usage: Block [blockNameId[:blockType]]

  • blocknameId:blockType - this optional parameter allows you to specify (by name or by block id) what block should by drawn, if this parameter is not given the block held by the player will by drawn

Sample:

/MCPainter Block Chest:1 - Draw a large chest block.

Alias: /Block

Statue

This command allows the user to draw a statue of himself or a statue of any skin he chooses. If no parameters are given the plugin will use the current skin of the player executing the command. If the u: (user name is case sensitive) parameter is used the plugin will draw statue of the player provided by this parameter. Finally when the parameter is given the plugin will use the skin file given in the url.

Permissions used by the command:

  • MCPainter.user.drawStatue.self
  • MCPainter.user.drawStatue.other
  • MCPainter.user.drawStatue.file

Usage: Statue [u:|skinUrl]

  • skinUrl - the url of the minecraft skin.
  • u:userName - the name of the player.

Sample:

/MCPainter Statue u:herobrine - Draw statue of herobrine.

Alias: /Statue Alias 2: /Statue_File

Mob (since 1.0-RC1)

This command allows the user to draw a statue of a mob.

Permissions used by the command:

  • MCPainter.user.drawStatue.mob.
  • Custom mobs can provide different permissions

Usage: Mob

  • mobName - the mob name

Alias: /Mob

Voxel model (since 1.0-RC5)

This command allows the user to draw voxel based 3D model. To use this command the model needs to by uploaded to the server. The model file needs to by placed in /plugins/MCPainter/models/ folder. Currently MCPainter supports Wavefront OBJ 3d model files and a wide range of texture files. Unfortunately the TIFF texture files are not supported.

Permissions used by the command:

  • MCPainter.user.renderModel

Usage: Render [ []]

  • model - the model file name
  • model size - the desired size of the model. Format: Width,Heigth,Depth. If you do not want to provide all the dimensions you can replace the 2 of them by "?".
  • clipping - how many blocks should by removed from X, Y and Z axis. This parameter is optional. Format: XL/XR,YT/YT,ZF/ZB.
  • XL - left x axis, (negative)
  • XR - right x axis (positive)
  • YT - top y axis
  • YB - bottom y axis
  • ZF - front z axis (positive)
  • ZB - back z axis (negative)
  • offset - how many blocks the center should by moved in X, Y and Z axis. This parameter is optional. Format: X,Y,Z

Alias: /Render

Sample: /MCPainter Render cat.obj ?,20,? 0/0,0/1,0/0 0,9,0

Jobs

This command displays number of block queued on the player job list. If no parameter is given it displays block queue for current user.

Permissions used by the command:

  • MCPainter.user.jobs
  • MCPainter.admin.jobs
  • MCPainter.admin.jobs.all

Usage: Jobs [u:|all]

  • u:userName - the name of the player.

Sample:

/MCPainter Jobs u:herobrine - Display the number of queued blocks for user herobrine.

/MCPainter Jobs all - Display the number of queued blocks for all users.

Purge

Clear the block queue for specified used (or all). If no parameter is used it clears the queue for calling user.

Permissions used by the command:

  • MCPainter.user.purge
  • MCPainter.admin.purge
  • MCPainter.admin.purge.all

Usage: Purge [u:|all]

  • u:userName - the name of the player.

Sample:

/MCPainter Purge u:herobrine - Clear the block queue for user herobrine.

/MCPainter Purge all - Clear the block queue for all users

Palette

This command allows the user to chose palette to use when drawing blocks, pixelart and statues.

Permissions:

  • MCPainter.user.palette.list
  • MCPainter.user.palette.change
  • MCPainter.admin.palette.change

Usage: Palette [[player name] <palette name>]

  • player name - name of the player to change the palette
  • palette name - name of the palette

Filter

This command enables the configuration of filters used for drawing piexel art and map images. If this command is used without parameters it displays currently configured filters (each player has its own filter stack). The filters are applied from top to bottom (from filter #1). Information on filter can by found here.

Permissions:

  • MCPainter.user.filter

Usage: Filter [clear|list|remove |help |add |insert ]

  • id - id of filter entry to remove
  • name - name of the filter
  • pos - position on with the filter is going to by inserted
  • params - parameters for the filter

Sample:

/mcpainter filter - list current filter configuration

/mcpainter filter help resize - display help on resize filter

/mcpainter filter add resize 80 60 interpolate - add resize filter (resize to 80x60 pixels using interpolation)

/mcpainter filter remove 2 - remove filter #2 from list

Reload

This command allows the admin to reload the plugin configuration

Permissions: MCPainter.admin.reload

Usage: Reload

Clone this wiki locally