The 3m modlists

[Phitherek_]

My 3m project has got to the point, when you can start creating your own repositories (modlists) and modinfos!

For mod developers/maintainers
Your job is to provide a modinfo file. I named it (but the name and extension aren' t necessary) modinfo.3mmi. The format is important - here is what should be inside:

Code: Select all

{modname} // Treat these as a commentary, do not copy this text nor the slashes to actual modinfo file! Modname can be a "basename" of a mod or something in that format (lowercase with no white spaces and no special signs).
[description]
The description of your mod.
[release]
release_no // Release_no is a regular int. It has nothing to do with version and should be increased with every change in mod that should be updated by 3m. I recommend starting from 1.
[deps]
dependency1 // A list of dependencies, each one in new line. If none, write "none". If default, write "default".
dependency2
...
dependency_n
[depsend]
[repotype]
archive/git // Either archive or a git repository
[repoaddr]
file/public_git_clone_addr // Either path to a file for download or public git clone address of a git repository
{end}

The simplest way, though, is to insert your mod into Rubenwardy' s Mod Forum / Browser, 3m will be compatible with it in a moment.

For modlist maintainers
If you want to create your own 3m "repository" - modlist, you must gather the modinfo file servers and paths for all the mods you want to include and then create the modlist file (named by me modlist.3mml, but once again, name and extension are not necessary) in the following format:

Code: Select all

{modname} // Commentary notice as above. Modname as above.
[server]
address.of.a.server.without.http // The lack of http:// before is important!
[modinfo]
/path/to/modinfo/file/on/the/server // The / at the beginning is important!
{end}

Existing modlists
Here is the list of existing modlists. To enable one of these, just add the entries to ~/.3m/remote_modlists file:

Official modlist (by Phitherek_):

Code: Select all

{official}
[server]
3m.phitherek.cba.pl
[path]
/files/modlist.3mml
{end}

Rubenwardy' s Mod Forum / Browser (by rubenwardy):

Code: Select all

{rubenwardy}
[server]
multa.bugs3.com
[path]
/minetest/forum/api/3m/getmods.php
{end}

Rubenwardy' s Mod Forum / Browser
Rubenwardy' s Mod Forum / Browser provides an API for 3m that generates modinfo and modlist files. It is currently a simplest way to add and manage your modinfo.

Requests
If you want your modinfo to be added to official modlist or your modlist to be added to the list above, feel free to ask me in this topic. Modlist should be provided in the following format:

Code: Select all

{modlistname} // Commentary notice as above. Modlistname restrictions as in modname.
[server]
address.of.the.server.with.modlist.without.http // The lack of http:// is important!
[path]
/path/to/modlist/file/on/the/server // The / at the beginning is important!
{end}

and modinfo in the modlist entry format described above, in the section for modlist maintainers.

Notice for moderators: I would be grateful if you could stick this topic at the top of "Modding General" or "Mod Releases" (which one is more appropriate).

[Phitherek_]

Announcenment: The Rubenwardy' s Mod Forum/Browser issues has been resolved, it is now fully compatible with 3m.