RUST Lusty Map v2.1.42

LustyMap is a plugin that adds an in-game Map and Minimap.

The plugin has two modes, the simple mode (default) uses a single image for the map and minimap, the complex mode uses a sliced up version of the map to allow for a zoomed in minimap.

IMPORTANT INFORMATION: This plugin requires the icon images to be added to the oxide data folder on the server (details below)

Below you will find information on:

• -Map Images
• -Icon Images
• -Using the complex map
• -Forcing the complex map
• -Map automation and beancan.io registration
• -Using custom map images
• -Tips for maintaining your server listing on beancan.io
• -How to find your API key on beancan.io
• -Accessing the map
• -Admin commands
• -Adding custom map markers
• -Using the anti spam functions
• -Chat/Console commands
• -Config options and what they do
• -API for developers

Friends integration​

This plugin supports friend lists from all Friends and Clans pluginsAny developer can add/manage a custom friends list via their own plugin using the API supplied below

Map Images​

The map itself can now be downloaded automatically and the plugin will slice it up accordingly. However to do this you must register your server on (More information below)

Icon Images - REQUIRED!​

Download the following zip file and extract it to your "/server/oxide/data/" folder. This contains all the map icons you will need. You may replace these icons with you own custom versions if you wish ->

Your folder structure should look like the following and the icons folder should contain by default 194 icon images

Complex Mode​

The complex mode (zoomed in minimap) uses a series of chopped up map images to provide a adjustable zoomed in view.This process is completely automated by the plugin. To take advantage of this simply set the config option UseComplexMap to true.

Forcing Complex ModeYou can also lock the map in a specified zoom level in complex mode by setting the config option ForceMapZoom to true.When forcing map zoom you must set ForcedZoomLevel between 1 and 3.This will disable the use of the regular minimap and only the set zoomed level will be accessible to all users

Map automation and Beancan.IO​

Credit to Calytic and Nogrod for providing a awesome map generator and a free to use API!Map generation and automation is now possible using API from beancan.io.

Simply register your server on the website and retrieve your API key. Your API key can be found by editing your server details, under the various options you will see a section titled API and your key is the entry labelled "Key"

Once you have your API key enter in into your config and reload the plugin.

The plugin will then contact beancan.io to generate and download your map.

Once the map has been downloaded, if you have complex mode enabled it will chop up and store all the pieces. This process may take a few moments. When that is done the plugin will become active and all players should be able to use the map.

Upon wipes LustyMap will detect a new map and will automatically download the updated map image, making the process entirely automated.

Users utilizing this feature will also have access to a map view that can be embedded on your website. When the map is generated via LustyMap it will be automatically updated so you will never need to update your website to match new maps. Browse to your server's map via beancan.io and click the "embed" button to obtain a URL to use

NOTE If the map generated does not match your map you can re-download the map by using the console command "resetmap" If the map does not match directly after a game update note that the map generator also requires updates so please wait for 5-10 minutes before trying to reset the map. If after using the command you map is still incorrect please leave a comment in the support thread stating your mapsize and mapseed along with a screen cap

Tips to keep your server listed on beancan.ioDirect from beancan staff:
Finding your API key

1. Navigate to the top right, open the drop down, and click my posts.
2. You will see all your posts there.
3. Click your server, then edit, then scroll down until you get to this.

Custom Map Images​

If you do not want to use maps provided by beancan.io you can still use a custom map image.To do this simply download your image and save it in your "/server/oxide/data/LustyMap/" folder.Then in your config change CustomMap_Filename to use the image filename and set CustomMap_Use to true. The process after this is the same as before, it just doesn't download the map from the web

Accessing the Map​

Players can press M to open the in game map (pressing M again will close it) (this can be changed in the config using the MapKeybind setting).

Players can hide the minimap using the <<< button located at the top right of the minimap (then >>> to open it back up)

Alternatively if you do not want to force a keybind on players they can use the chat command /map to open the map or /map mini to open the mini map

Admin Commands​

All previous admin commands have been removed due to the way the new version generates the UI. All these options are still available to change in the config and will require a reload of the plugin after making any changes to generate the new UI

Adding Custom Markers - via chat commands (See Below)By using the command /marker you can add and remove custom map markers.When adding a marker you will have the option to specify a custom icon (file). This icon MUST be located in your "/oxide/data/LustyMap/custom/" folder and the file must be a .png.When typing the command you must type the filename without the extension. For example:We have a custom icon file name icon.png, the command will be "/marker add name icon"Alternatively you can leave it blank and the default icon will be supplied

Map Spam Monitoring​

It has been brought to my attention that some deviants may spam the map open/closed in order to lag a server and potentially crash it.To combat this I have implemented a spam monitoring system. This system will monitor when a user changes map mode rapidly, whether it being opening and closing the map, or zooming in and out etc.If the user changes type more then once in the set amount of time (default 3 seconds) it will be registered as potential spam. By default after 5 rapid changes the user will receive a warning, and after 10 rapid changes the users map will be disabled for 2 minutes.There are a few options in the config regarding this system including a option to enable/disable the system entirely

Linux Users​

The map splitter requires LibGDIPlus to be installed on your system.
Afterwards restart your system for the changes to take effect

Chat Commands​

• /map admin - Toggles Admin View On/Off (allows you to see all player on the map) - Requires auth level or permission lustymap.admin
• /marker add <name> <opt:icon> - Add a new map marker on your position with a optional custom icon
• /marker remove <name> - Remove a custom map marker by name

Console Commands​

resetmap[/COLOR] - Force the plugin to erase existing image data and re-download all images (used to reset generated maps)

Configuration​

The settings and options can be configured in the LustyMap file under the config directory. The use of an editor and validator is recommended to avoid formatting issues and syntax errors.

For Developers​

Custom Markers
Map Management - For use with fullscreen UI to disable LustyMap from overlapping
Custom Friend Lists