GameINIs are online .ini files, which are the same for everyone in the game. GameINIs are accessible without logging in.

All data in GameINIs can be freely edited by any connected client.

Replies (30)

Last message on 9 Apr 2020

Solidplasma on 24 Sep 2014, 04:40:34
I am trying to use an online gameINI as a level portal for user made levels, however when I write to it or even manually add a section to the ini on the website, it doesn't appear on the webpage immediately, even after refreshing the page. I thought it wasn't working at all, but after attempting to upload a level several days ago, I came back today to find it fully uploaded and working. Is there a way to force sync the update, or is there a reason it isn't instantaneous?
Size43 (Administrator) on 23 Mar 2015, 20:00:22
This is because the INIs are cached on the game server. It turned out that saving INIs was really slow, so it's done in the background and some time after the last change.
Forgeio on 12 Jul 2019, 18:12:51
Hey! So I'm working on making a custom chat system with Game INIs, and I think I keep hitting the size limit really quickly, or maybe the players update the INIs too often, even without that many messages being used, and it gives the players an error after a few messages have been sent. The system I'm using is basically whenever a player sends a message, it goes through a for loop and changes all of the game INI keys to the INI key below, and then changes the first one to the message the player sent. Is there any way this system could be optimized, or would it be more efficient using a different GMServer data storage method, like binary data blocks maybe? Thank You! And I'm sorry if I'm ignorant to some obvious reason this wouldn't work, I'm still learning a lot about implementing multiplayer and everything haha.
Forgeio on 12 Jul 2019, 18:15:58
Now that I'm checking it over, it may have something to do with the way I'm drawing them aswell, in the draw event it checks if the ini exists and then reads the ini, maybe since this is happening every step it is giving an error after a certain time. I'm not sure if that's how it would work, but that's the only other thing that I could think of.
Size43 (Administrator) on 24 Jul 2019, 21:35:38
INIs are cached, so reading it every step should not be a problem.

Though please consider using the built-in chat system, as it's much more efficient than any of the other features in the extension that you could try to use as a chat system. If you just want to draw your own chat, you can do that with the built-in chat system too, see for example gms_chat_get_text and gms_chat_get_sendername.
Chreech on 8 Apr 2020, 17:21:38
Is there any way to check whether it has successfully read the ini or written the ini so that we may take next step accordingly? Like you said reading it each step is not possible so we need to know when it's done.
Size43 (Administrator) on 9 Apr 2020, 19:51:45
Reading is always instant, since INI files are downloaded upon connecting or logging in, not when calling gms_ini_*_read. So as soon as gms_info_isconnected or gms_info_isloggedin returns true, you know that the GameINI and PlayerINI are available, respectively.

If you have values that change once every ~3-5 seconds or slower, just save the new value to the INI every time. It's not really worthwhile to figure out when exactly the values are saved, as long as you're still connected to the server (gms_info_isconnected).
Size43 (Administrator) on 9 Apr 2020, 19:52:22
If you do need to know when an INI write has been fully processed, and this is a big ugly hacky way to do this so don't do it if you don't have to, is to open an empty BDB after issuing the gms_ini_*_write commands. Since functions you execute are sent in order to the server, you can use opening a BDB as a sort of indicator of when everything you've sent before the gms_bdb_open request has been processed. So just open a BDB non-exclusively, and when the callback is called you know that everything you did before the open has been processed.
Forgeio on 2 Aug 2019, 23:05:50
I would use the build-in chat system, however, there is no way of saving the history of the chat (that I know of, I may be just looking it over somehow) so I can review it.
I also do not like how I'm limited to the amount of chat messages I can send in a certain amount of time, to prevent spam, even though I'm set as an administrator for my game. Overall, I'd really like more control, and coding the chat system myself would give me that control.
For now, I'll use the built in chat system though, it would be really awesome if you considered some alternative way/more efficient way in the overhaul of game maker server to program your own chat system, or have more control over the chat system.
Size43 (Administrator) on 10 Aug 2019, 21:58:28
Correct. You can't see chat messages if you weren't in the session where the message was sent at that time. Unfortunately I can't give you a perfect solution right now.

Like almost every other part of GameMaker Server, the chat will also see some changes in the rewrite that make it more flexible and nicer to use.
Help_PW on 6 Oct 2017, 19:09:48
If its possible how can i save "buildings" created by players with game inis?
Size43 (Administrator) on 15 Oct 2017, 22:16:30
You could port any system using normal INIs to the gameINIs
AaronSolstice on 17 Sep 2017, 14:47:25
Is there a way to delete a full section of an ini, with one single function, instead having to delete all the keys of that section, in order to delete that empty section automatically?
AaronSolstice on 17 Sep 2017, 14:48:50
sorry for the double post, I don´t see this one posted :(
AaronSolstice on 17 Sep 2017, 14:45:49
Is there a way to delete completely an INI section with one single function?

I know if you delete all the keys of that section this is automatically deleted, but I´m saying to delete all the INI section, without the need to delete all single key in a case-by-case basis.
Size43 (Administrator) on 25 Sep 2017, 16:58:30
This is not possible.
perilousproductions on 18 May 2017, 03:16:27
never mind I figured it out thanks anyway! :D this is awesome will definitely donate once I make some revenue!
perilousproductions on 18 May 2017, 02:33:54
also is it possible to access an ini key using its index number so I could loop through a section to find the information I needed? Thanks again.
Ytsim on 26 Dec 2017, 05:30:07
I dunno if you are still active here, but a good way to do it is store the values in the ini separated by commas or something like "value1,value2,value3,value4,value5", pull the data, split it at the commas, and store them in an array, then you can loop through the array and get the data needed, all in one key too.
Size43 (Administrator) on 27 May 2017, 15:56:41
This is not possible.
perilousproductions on 17 May 2017, 19:50:27
How long does it take for a game ini to show up on the site?
As mentioned by someone else I am also making a level portal for player created levels,
I used gms_ini_game_write about half hour ago and it's still not showing up under the ini game section.
How long does it usually take? because I have a script that checks if the ini exists because if it does I want to delete the ini before rewriting it to make sure it isn't posted twice and I can't check if the ini has been posted if it takes over an hour to actually post :/

Or would posting an ini under the same section and key write over it the old one anyway, even if it is delayed?
Sorry for the awkward question, thanks!
Size43 (Administrator) on 27 May 2017, 15:56:18
If there are no players online in your game, it will be saved to the database within 15 minutes after the last write. You may need to log out and back in (on this site) before the changes show up)
amkgames on 11 May 2017, 11:48:31
Hey, Is it possible to write and read string with it?
amkgames on 11 May 2017, 13:17:38
Tried myself, it is possible.
Zoythrus on 14 Apr 2015, 04:18:35
Hey, while I know what an .ini *is*, I'm confused as to what they're used for here. Could you please explain why we need them?
Solidplasma on 14 Apr 2015, 08:46:06
Whatever you need universally accessible data for. I used them to make an online level portal for my game.
amkgames on 5 Apr 2015, 21:19:43
Game INI and Player INI are server sided?
Size43 (Administrator) on 6 Apr 2015, 11:16:30
Ajay on 20 Mar 2015, 05:34:42
Please make different feedback function for our customers. or else make folders into Sections and Key function into GAME_INI.
Size43 (Administrator) on 23 Mar 2015, 19:58:51
It's pretty easy to fake a folder structure in a GameINI. You can save a category or something like that and when displaying a certain category, only show items belonging in that category.