Mod Compass GPS [compassgps]

Discussion in 'Mod Releases' started by Kilarin, Jun 12, 2014.

  1. Kilarin

    Kilarin New Member

    Created for Mintest, but, at least in single player mode, it seems to be compatible with Freeminer

    Compass GPS version 1.8
    This mod creates a customizable compass with user settable bookmarks and shared and admin bookmarks in multiplayer.

    Echo created a compass mod back in 2012:
    PilzAdams made a modification of it, which I can not find the source to, I don't know how much of PilzAdams changes made it into the later versions of Echo's mod.
    Then in 2013 TeTpaAka made a fork of the compass mod that he called compass+
    This fork added the ability to "bookmark" specific places, and a gui so you could choose what point the compass should point to.

    This is my fork of TeTpaAka's fork of Echo's mod. :)

    The compass mod as it was is REALLY cool I love the way Echo managed to make the compass in your inventory actually change it's image to point in the direction of it's target


    And TeTpaAka's gui, file io, and coding for multiplayer games was simply amazing. But as I was learning from their awesome code, I saw some changes I'd like to make using these new ideas, as well as some things I learned while looking at other mods. So, with complete and total respect for the original awesome mods, and hopefully in the same spirit as theirs, I present my own fork of the fork. CompassGPS

    The crafting recipe for a compass is unchanged:

    Compass GPS introduces several other changes though. First of all, this mod adds a heads up display that indicates your current position, and the name of the bookmark the compass is pointing at, that bookmarks pos, as well as the distance to that bookmark.


    The hud updates constantly as long as the compass is in one of your active inventory slots, so you can always know where you are in relation to the target node, and how far away it is.

    There is a GUI that pops up whenever you wield the compass and left click. I never played with a GUI in minetest before, so this was a new experience for me, I learned a lot and made quite a few changes:


    To create a new bookmark, type the name into the "bookmark:" field and click "Create Bookmark" (or just hit enter). To remove a bookmark, select it from the list and click "Remove Bookmark." A confirmation dialog will appear and the bookmark will only be removed if you click "YES".

    The bookmark list has been expanded from a dropdown into a textlist to improve visibility. Select any bookmark in the list by clicking on it, and then click "Find Selected Bookmark" to make the compass (and hud) point at that location. "default" is always at the top of the list and will point to (0,0,0) or your bed from PilzAdams bed-mod, or home location as defined in the sethome-mod. (Setting default to your bed or sethome is old code, I modified it to make it work with my new version, but I cant take credit for the idea or basic structure.) The rest of the list are bookmarked locations that you have set and named

    Just click in the "Sort by" box to change whether the bookmarks are sorted by name, or by distance from your current location. ("default" will still always be the first item in the list no matter which way you sort it)

    Click in the "Dist" box to change whether the distance is calculated in 3d (including your distance in the vertical direction) or in 2d (x and z coords only, ignore vertical distance)

    Down at the lower right of the screen, I'm certain you noticed the "Teleport to bookmark" button. That button appears if, and ONLY IF the player has teleport privileges. If they do, then they can select any bookmark out of the list, click on teleport, and be instantly transported to the location of that bookmark. Since the user already had teleport privileges, this just saved them some typing, it's not adding any new abilities.

    If you click the "Settings" button in the upper right hand corner it brings up a screen where you can customize the appearance of your compass gps:


    I figured the position of the hud text was likely to be something that people would want to customize, so here in the settings gui are the x and y coords for the hud text. Just enter the new coords where you want the hud text to appear and click "Change Hud"
    The cords must be between 0 and 1 and represent a percentage of the screen, so x=0 would put the text at the far left of the screen, and y=0.98 would put the text almost at the bottom of the screen. The default is x=0.4 and y=0.01, and that is displayed right over the input boxes so the user can easily set them back to the default if they are having trouble placing the hud. If you change either the x or y coord to a number that is out of range (less than 0 or greater than 1) then the hud will not be displayed. That makes it easy to turn the hud off if you wish.
    You can also change the color of the hud text by changing the value in the "Color" field here. Again, click "Change Hud" to make the update appear.

    AND, there are three buttons here that allow you to select from 3 different styles of compass images. The basic compass image by Echo. A nice wooden compass image by Bas080. And a high resolution compass image by spootonium.

    In Multiplayer, there are now shared and admin bookmarks!
    If a player has the new "shared_bookmarks" privilege, then they will get the "Create Shared Bookmark" button and be able to create bookmarks that all players on the server can see and use. Shared bookmarks are preceded by *shared* and the name of the player that created them. There is a variable near the top of the init.lua called max_shared. This controls the maximum number of shared bookmarks that an individual player can create. It is set to 10 by default, but the server admin can change it to whatever they want. A player can delete their own shared bookmarks, but they can not delete anyone else's (unless they are an admin, then they can delete anyone's shared bookmarks)

    If a player has the "privs" privilege, then they will get the "Create Admin Bookmark" button. Admin bookmarks are intended to allow the admins to mark important places in their world that they want everyone to be able to find. There are no limits on how many admin bookmarks can be created. Only Admins can delete admin bookmarks.

    In a multiplayer game, all players get the "Show: Private, Shared, Admin" checkboxes. You can use these checkboxes to toggle which type of bookmarks show in your list. If you uncheck all three the system will automatically recheck "Private" for you.

    The bookmark list is saved any time a user changes it. All of your other settings, the currently selected bookmark, sort order, distance function, and hud position and color, and compass type, are saved whenever a user leaves the game, and on game shutdown. So if you move the hud down to the lower right hand corner of the screen, and then quit, the hud will still be in the place you put it when you restart the game later.

    The Chat Commands from the orignal compass mod still work, but only on private bookmarks. Chat commands available are:
    set_bookmark <bookmark name>
    find_bookmark <bookmark name>
    remove_bookmark <bookmark name>

    I also fixed a few bugs while I was working on this. There was a problem in the mod that caused compass to jump around in inventory if there were empty slots above it, that is fixed now. And there was also a problem with the bookmark list not being saved after you removed a bookmark if you didn't add a new bookmark afterwards. Now the bookmark list is saved whenever you change it, either adding or removing.

    The code is kinda a mess, because I was learning a lot of new things while working on it. I hope to do a clean up on it sometime in the near future, but I wanted to release it now so some people could start testing it. Please do not hesitate to offer critiques, criticism, or coding advice. I'm new to lua and minetest and could use the help.

    And above all, if you run into a bug, please let me know!

    Original mod is by Echo and TeTpaAka, and probably PilzAdam. Cactuz_pl clockmod showed me how to write the hud to the screen. My son offered a lot of advice and suggested several changes. I got an example of how to sort lists in lua from Michal Kottman on StackOverflow. Big thanks to Bas080 and spootonium for providing some very nice alternate images for the compass gps mod! Also thanks to Topywo for the shared bookmarks idea, and to my son for several ideas, corrections, and testing help.

    Original code by Echo, PilzAdam, and TeTpaAka is WTFPL. My changes are CC0 (No rights reserved)
    textures: original compass textures: CC BY-SA by Echo
    compass b textures: CC BY-SA by Bas080 (slight modifications by Kilarin)
    compass c textures: CC BY-SA by Andre Goble
    (slight modifications by Kilarin)

    default is the only requirement.
    PilzAdams Beds mod and the sethome-mod are supported if you have them.

    This mod will clash with both the original compass and compass+ mods. They should not be installed and enabled at the same time as compassgps. HOWEVER, compassgps is 100% compatible with the bookmarks file from the compass+ mod. So if you were using compass+ and switch to compassgps you will NOT lose your previous bookmarks.

    github source:


    To install:
    Simply unzip the file into your mods folder, then rename the resulting folder from compassgps-master to compassgps
    Last edited: Oct 12, 2014
  2. Enke

    Enke Member

    Okay, so there's electical engineering, which is pretty smart.
    There's War and Peace, which is pretty dang smart.
    There's general relativity; really very smart.
    And then there's this. SHEER BRILLIANCE!

    On a side note, an estimated 14 people understand general relativity. About half of 'em are dead.
    On another side note, 74.13% of statistics are not only made up, but have decimals added to seem more legitimate.
  3. jojoa1997

    jojoa1997 Member

    One of those people who are dead is me.
    General relativity is this
    50% of this post is the truth and 50% is a twist. :3
  4. Kilarin

    Kilarin New Member

    There was a bug in the multiplayer version of this code that would cause a crash the first time the formspec was loaded. It has been corrected and the newest version (1.7) is available at the above github link.

    Please let me know if you have any problems.

  5. Kilarin

    Kilarin New Member

    Version 1.8 is online. I corrected the code to remove a bug in multiplayer, and to make it compatible with unified inventory.
  6. 4aiman

    4aiman Member

    So... there's no way to disable it?
    Say, I don't want to see any HUD... but don't want to put a compass away from the wieldlist either... What should I do to disable HUD while having a compass in the wieldlist?

    Also, is there a way to share one/all of your bookmarks with just some players?
    Say, I made a hidden batcave and want only my best buddy to know where it is - that's when such a feature may be helpful :)
  7. Kilarin

    Kilarin New Member

    If you change either the x or y coord to a number that is out of range (less than 0 or greater than 1) then the hud will not be displayed. That makes it easy to turn the hud off if you wish.

    That would be a most excellent idea, but there is no way to do so currently, and implementation would be a bear. I'll keep the idea on the back burner and if anyone actually uses compassgps on a server and requests this, I'll see what I could do. It would need to be integrated with "groups" somehow.
  8. 4aiman

    4aiman Member

    To keep the bear sleeping...
    Maybe only player_count of groups are needed?

    What about the following:
    • Have a global compass_VIPs table.
    • Someone joins some server with Compass GPS enabled.
    • Your mod creates a sub-table compass_VIPs[new_player_name]={}
    • When this player will share his waypoint, the mod will ask: everybody or just VIPs.
    • Suppose he'll chose only VIPs.
    • Then show a bookmark only to the list in compass_VIPs[new_player_name] table. You already doing this for admins, so there won't be so much changes in comparison with the custom groups.
  9. alaytangerang

    alaytangerang New Member