Custom Sign Images: Difference between revisions

From Eco - English Wiki
[checked revision][checked revision]
(Changed version)
(Added warning about long names)
 
Line 5: Line 5:




Inside this GameObject you should have an Image component that contains your prepared sprite Image you'd like to add. In our case this contains the Eco planet logo.
Inside this GameObject you should have an Image component that contains your prepared sprite Image you'd like to add. In our case this contains the Eco planet logo. For best results try and keep your image file names short and ideally matching the name of the GameObject. A name that is too long may fail to load and show as plain text instead of the intended image.
[[File:ExampleImage-SignTutorial.png|none|thumb]]
[[File:ExampleImage-SignTutorial.png|none|thumb]]



Latest revision as of 04:20, 13 January 2022

Starting with Eco 9.4.5 it is now possible to add image assets to Eco without the use of code for use on Signs or other text inputs that accept the <ecoicon> tag.

Adding a Custom Image[edit | edit source]

To add a custom image to Eco. Create a blank new client Modkit project and open the default modkit scene template. Create a new GameObject under the Items root GameObject. Similar to items there are naming rules that must be followed when creating this object. It should match "[YourUsageName]Image" In this example we are going to add LogoPlanetImage which will appear in game under "LogoPlanet".

LogoPlanetImage-SignTutorial.png


Inside this GameObject you should have an Image component that contains your prepared sprite Image you'd like to add. In our case this contains the Eco planet logo. For best results try and keep your image file names short and ideally matching the name of the GameObject. A name that is too long may fail to load and show as plain text instead of the intended image.

ExampleImage-SignTutorial.png


From here you assign your scene tag and publish the Modkit bundle as normal.

Using the Custom Image[edit | edit source]

To use your new image in game use the ecoicon tag with the name attribute containing the name of your new image GameObject. In our case that is

<ecoicon name="LogoPlanet">

The image will then try and automatically fill the available space. Note our example image is low resolution. You can use high resolution images for better quality.

SignExample-SignTutorial.png

Tips for usability[edit | edit source]

This section outlines some easy to follow steps to make your custom images easy to use.

Easy to type names[edit | edit source]

If the images are intended to be used by everyone on the server try and come up with easy to remember and short names. No one enjoys typing out lengthy HTML code in their signs. Keeping it short makes it easier for people to remember their favorite images without having to constantly look it up.

Reference Page[edit | edit source]

To make sure your server knows what images are available for easy public use consider adding a custom Ecopedia page with all the available images and possibly a sample tag for displaying them on signs. This can be achieved by following the documentation available here about custom Ecopedia pages.