炫宙菌：创建页面，内容为“none Magic includes a robust…”

2021-06-27T15:40:05Z

创建页面，内容为“thumb|none Magic includes a robust…”

新页面

[[File:https://lh5.googleusercontent.com/-QvcXC33t6K4/U1qTbWjp4dI/AAAAAAAAAU4/QIfysxqbFT4/w854-h480-no/2014-04-25_09.50.25.png|thumb|none]]

Magic includes a robust "image map" system, for putting PNG and GIF images on to Minecraft maps. You can use these maps as decorations in item frames, special collectable items, or whatever you can dream up.

Using the "mmap" command, you can create, edit and remove maps:

* mmap load <url> [name] [width] [height]: Load an image into a map. Will create a new map if this image hasn't been loaded before. Can load URLs, or files (relative to your MC server path)
* mmap give [player] <map id> : Give yourself or another player a specific map
* mmap list [filter] : List all maps, or search for specific maps by keyword/filename
* mmap remove <map id> : Unregister a specific map id, returning it to a normal map
* mmap import [Pixelator config file] : Import images from Pixelator (You should disabled Pixelator prior to doing this!)

== Animated GIFs ==

If you were wondering "this can't possibly support animated GIFs, can it?" Well, it can!

'''Disclaimer''': I would not recommend using these very much, if at all! The bandwidth cost may be very high. It is effectively 16k x number of players viewing per animation frame time. Minecraft does not cache or compress these in any way, they are sent from the server to the client .. you have been warned!

[http://www.youtube.com/watch?v=6SgD163Xrcs [[File:http://img.youtube.com/vi/6SgD163Xrcs/0.jpg|fig:]]]]

== The Camera Spell ==

The "camera" spell and item use this system for generating player portraits. You will see any photos taken with a camera show up in the /mmap list.

''Note:'' It is generally easier to use the /mmap command for dealing with maps, but I've left this section here for reference.

The camera spell can be used from the command-line to decorate your 
world with images. There are a few key parameters:

* name: A player's name, to create a portrait. Can also be used to set 
a custom name for an id or url map.
* url: A full url to a PNG image to show on the map.
* x: The x offset, in pixels, to start rendering from. Default is 0.
* y: The y offset, in pixels, to start rendering from. Default is 0.
* width: How many x pixels of the image to use. Default is 128.
* height: How many y pixels of the image to use. Default is 128.

Or, you can use the following to get an existing map:

* id: A map id : Useful for creating a copy of an existing map (this 
can be done with /give, too)

== Examples ==

<pre class="">/cast camera url http://i.imgur.com/UUyPoDi.png</pre>
You can also give it a name, which will make it easier to find later, and also name the photo for you:

<pre class="">/cast camera url http://i.imgur.com/UUyPoDi.png name Daft</pre>
[[File:http://i.imgur.com/udTNu8h.png|thumb|none]]

You can use "/magic list maps <keyword>" in-game or via the console to 
search for maps. The list will include the id's, so you can then use 
"/cast camera id <id>" to get a copy of a previously loaded map.

[[File:http://i.imgur.com/nhF5CzC.png|thumb|none]]

Maps are loaded on demand (both from the web and into memory), and 
cached on the server for performance. If you wish to clear this cache, 
use "/magic clearcache".

Map URLs are saved in data/imagesmaps.yml. This file can be manually 
edited, though Magic saves to it frequently so editing while the server 
is offline is best. If you do edit the file, you may create new entries 
by specifying a non-integer string (e.g. "new1") as the key. Magic will 
generate a new map and id for your entry on next start. Make sure to 
create a backup, YML is a fickle mistress.

== Cropping and Scaling ==

Images will be auto-scaled to fit on a 128x128 map canvas by default. You can scale and crop yourself with the x, y, width and height parameters- for instance

<pre class="">/cast camera url http://i.imgur.com/UUyPoDi.png x 100 y 100 width 128 height 128</pre>
Will produce the following cropped image:

[[File:http://i.imgur.com/EFieeGX.png|thumb|none]]

== Command Blocks and Console ==

You can set up command blocks that use "castp @p camera id <foo>" 
to give out artwork or portraits. "castp @p camera target self" can be 
used for a photo booth.

Using /castp from the console can also help you get around the chat 
length limitations for using longer urls.

<pre class="">castp NathanWolf camera url http://upload.wikimedia.org/wikipedia/commons/thumb/e/ea/Van_Gogh_-_Starry_Night_-_Google_Art_Project.jpg/1024px-Van_Gogh_-_Starry_Night_-_Google_Art_Project.jpg</pre>
[[File:https://lh6.googleusercontent.com/-fu_nlaitBgA/U1qTbu1tgUI/AAAAAAAAAU8/F2nakT_ZJ0o/w854-h480-no/2014-04-25_09.51.13.png|thumb|none]]

Magic/ImageMaps - 版本历史

炫宙菌：​创建页面，内容为“none Magic includes a robust…”

炫宙菌：创建页面，内容为“none Magic includes a robust…”