Skip to content

Suprcheese/Map-Ping

Repository files navigation

Map Ping 1.0.4
==============

Version 1.0.4 was released March 13, 2018, was tested using Factorio v0.16.29, and was authored by Supercheese, with contributions from meslem12.

This mod adds a Map Ping Tool that is free to craft and available immediately at the beginning of a game, and also available via hotkey.
This tool allows you to highlight a location on the map that will be visible to other players. Clicking with the tool will "ping" the selected location to players of your force.
A distinctive sound will play and a swirling graphic will be visible on the field and a custom marker, complete with blinking pointer, will be visible on the minimap.
A custom alert will also be shown next to your toolbelt, similar to the alerts for destroyed structures.

You can also Shift+Click with the ping tool to enter Selection Display Mode. This will draw an arrow pointing towards any entity you hover your cursor over, and this arrow will be visible to all players on your team.
You exit Selection Display Mode simple by changing your held item (e.g. pressing Q by default). Only one player can be in Selection Display Mode at a time.

In order to prevent abuse in an MP environment, whenever an admin selects the Map Ping Tool, an admin GUI will open that allows them to toggle permissions for all players in the game.
If players are abusing the ping tool, they can be easily banned from using it. The default permission for new players that join follows the state of the "Toggle All" checkbox; if the box is unchecked, new players will be banned by default.

This mod has configuration options available through the in-game mod options menu (Options -> Mods). Here you may adjust parameters such as:

-The global lockout time between consecutive map pings
-How long a map ping lasts
-Enable "hotkey-only" mode, keeping your inventory free of ping tools, instead relying on the keybind to ping the map.


Credits:
--------

The ping sounds were obtained from:

http://opengameart.org/content/sound-effects-sfx025
	It was uploaded by the user jalastram, under the OGA-BY License (http://static.opengameart.org/OGA-BY-3.0.txt)

http://opengameart.org/content/sci-fi-sound-effects-library
	It was uploaded by the user Little Robot Sound Factory, under the CC-BY License (https://creativecommons.org/licenses/by/3.0)

https://www.freesound.org/people/qubodup/sounds/238995
	It was uploaded by the user qubodup, under the CC-BY License (https://creativecommons.org/licenses/by/3.0)

The Map Ping Tool icon was obtained from: http://opengameart.org/content/cursors-arrows-map-markers-for-ardentryst-by-jordan-trudgett
	It was authored by Jordan Trudgett and submitted by the user qubodup, under the CC-BY License (https://creativecommons.org/licenses/by/3.0)

The spinning ping graphics were obtained from: http://opengameart.org/content/%E2%80%9Calien%E2%80%9D-crosshairs
	They were authored by Pyccna and submitted by the user Calinou, under the CC-BY License (https://creativecommons.org/licenses/by/3.0)


Thanks to the forum, Github, and #factorio IRC denizens for inspiration, advice, & bugtesting.

See also the associated forum thread to give feedback, view screenshots, etc.:

https://forums.factorio.com/viewtopic.php?f=97&t=34902