Modding Tutorial Book (new: Code architecture, unit testing)

User avatar
Lone_Wolf
Member
Posts: 2343
Joined: Sun Apr 09, 2017 05:50
GitHub: LoneWolfHT
IRC: Lone_Wolf or LoneWolfHT
In-game: Lone_Wolf
Location: Not there, THERE!

Re: Modding Tutorial Book (new: Privileges)

by Lone_Wolf » Post

Could you add a part that shows you how to register a tool? Or is there and I missed it?
I'm having trouble understanding the highlighted text:
snappy={times={[1]=1.90, [2]=0.90, [3]=0.30}, uses=40, maxlevel=3},

User avatar
Napiophelios
Member
Posts: 1017
Joined: Mon Jul 07, 2014 01:14
GitHub: Napiophelios
IRC: Nappi
In-game: Nappi

Re: Modding Tutorial Book (new: Privileges)

by Napiophelios » Post

Lone_Wolf wrote:Could you add a part that shows you how to register a tool? Or is there and I missed it?
I'm having trouble understanding the highlighted text:
snappy={times={[1]=1.90, [2]=0.90, [3]=0.30}, uses=40, maxlevel=3},
Krock explains it pretty well here

User avatar
Lone_Wolf
Member
Posts: 2343
Joined: Sun Apr 09, 2017 05:50
GitHub: LoneWolfHT
IRC: Lone_Wolf or LoneWolfHT
In-game: Lone_Wolf
Location: Not there, THERE!

Re: Modding Tutorial Book (new: Privileges)

by Lone_Wolf » Post

Where can i get ChatCmdBuilder?

User avatar
rubenwardy
Moderator
Posts: 6153
Joined: Tue Jun 12, 2012 18:11
GitHub: rubenwardy
IRC: rubenwardy
In-game: rubenwardy
Location: United Kingdom
Contact:

Re: Modding Tutorial Book (new: BasicMapOps, AutoErrorChecki

by rubenwardy » Post

Two new chapters added:
Also made ChatCmdBuilder a bit less misleading, and added a short section on Lua patterns

Available to download in HTML or PDF form: https://github.com/rubenwardy/minetest_ ... g/20180225
The book is 110 pages when made into a standard paperback book!

hajo
Member
Posts: 602
Joined: Thu Oct 13, 2016 10:45
Location: DE
Contact:

Re: Modding Tutorial Book

by hajo » Post

rubenwardy wrote:Two new chapters added:
I had another look at your book, and noticed
* "Getting and Setting Privileges" - needs an explanation how to check if a player has an account
* Detached inventory - where are they stored, is there a sizelimit ?

Also:
* How about geany, to recommand as editor / IDE ?
* In the PDF, some headings should start on a new page, eg.
Mod Folder Structure, Overriding, Foods, Liquid, Map Structure-Reading, Writing Nodes,
Getting a Metadata Object, Setting Metadata, Admin complex command,
Displaying Formspecs, Inventory-More Methods, Adding to a List,
Github, or another VCS

KCoombes
Member
Posts: 412
Joined: Thu Jun 11, 2015 23:19
In-game: Knatt
Location: SW Florida, USA

Re: Modding Tutorial Book (new: BasicMapOps, AutoErrorChecki

by KCoombes » Post

Most excellent resource! Any chance of updating the downloadable examples file?

User avatar
Wuzzy
Member
Posts: 3963
Joined: Mon Sep 24, 2012 15:01
GitHub: Wuzzy2
IRC: Wuzzy
In-game: Wuzzy

WHY?

by Wuzzy » Post

Why is this still not in official?
WHYYYYYY?
My creations. I gladly accept bitcoins: 17fsUywHxeMHKG41UFfu34F1rAxZcrVoqH

User avatar
MineYoshi
Member
Posts: 5373
Joined: Wed Jul 08, 2015 13:20
Contact:

Re: Modding Tutorial Book (new: BasicMapOps, AutoErrorChecki

by MineYoshi » Post

Hi, Rubenwardy. Recently I got illuminated while eating a piece of chicken and I got the idea of translating your modding tutorial to Spanish. Do you allow me to do so? Also, do I edit the HTML files directly - whilst adding the UTF-8 header to assure the characters will show correctly - or do I send you the translation on any other form?
Oi

muhdnurhidayat
Member
Posts: 302
Joined: Wed Nov 16, 2016 22:55
GitHub: mnh48
IRC: muhdnurhidayat
In-game: muhdnurhidayat
Location: Wangsa Maju, Kuala Lumpur, Malaysia
Contact:

Re: Modding Tutorial Book (new: BasicMapOps, AutoErrorChecki

by muhdnurhidayat » Post

MineYoshi wrote:Hi, Rubenwardy. Recently I got illuminated while eating a piece of chicken and I got the idea of translating your modding tutorial to Spanish. Do you allow me to do so? Also, do I edit the HTML files directly - whilst adding the UTF-8 header to assure the characters will show correctly - or do I send you the translation on any other form?
there's instruction on how to add language on the website
https://rubenwardy.com/minetest_modding ... w-language

just follow that for any languages... but it will take some time to translate as there's many pages
(am translating the book to Malay locally at the moment, will only make pull request once everything is translated)
[ Full signature ] - UTC+8 here, I'm muhdnurhidayat in most Minetest servers. / Twitter ✂️- - - - -

Contributes to Minetest Wiki.
Also uses MT Offtopic forum.
You just read my profile, right?
Because these few texts of signature only appear on profile page as the texts are cut in signature. xD

User avatar
MineYoshi
Member
Posts: 5373
Joined: Wed Jul 08, 2015 13:20
Contact:

Re: Modding Tutorial Book (new: BasicMapOps, AutoErrorChecki

by MineYoshi » Post

muhdnurhidayat wrote:
MineYoshi wrote:Hi, Rubenwardy. Recently I got illuminated while eating a piece of chicken and I got the idea of translating your modding tutorial to Spanish. Do you allow me to do so? Also, do I edit the HTML files directly - whilst adding the UTF-8 header to assure the characters will show correctly - or do I send you the translation on any other form?
there's instruction on how to add language on the website
https://rubenwardy.com/minetest_modding ... w-language

just follow that for any languages... but it will take some time to translate as there's many pages
(am translating the book to Malay locally at the moment, will only make pull request once everything is translated)
Oh. Thank you very much. :-)
Oi

User avatar
Wuzzy
Member
Posts: 3963
Joined: Mon Sep 24, 2012 15:01
GitHub: Wuzzy2
IRC: Wuzzy
In-game: Wuzzy

Crazy idea for which I will get shouted at by every core dev

by Wuzzy » Post

Crazy idea for which I will get shouted at by every core dev: Include the modding book into the Minetest repository.
My creations. I gladly accept bitcoins: 17fsUywHxeMHKG41UFfu34F1rAxZcrVoqH

User avatar
TumeniNodes
Member
Posts: 2853
Joined: Fri Feb 26, 2016 19:49
GitHub: TumeniNodes
IRC: tumeninodes
In-game: TumeniNodes
Location: in the dark recesses of the mind
Contact:

Re: Crazy idea for which I will get shouted at by every core

by TumeniNodes » Post

Wuzzy wrote:Crazy idea for which I will get shouted at by every core dev: Include the modding book into the Minetest repository.
Why?
Not being argumentative or a smartass..., legitimately asking why. What would be the reason, and the benefit, etc..

IMO it is better as a separate project. If it were merged in or lumped in, it may create some confusion and neglect over time
Ich mag keine grünen Eier und Schinken, ich mag sie nicht Sam I Am

User avatar
texmex
Member
Posts: 1752
Joined: Mon Jul 11, 2016 21:08
GitHub: tacotexmex
In-game: tacotexmex

Re: Modding Tutorial Book (new: BasicMapOps, AutoErrorChecki

by texmex » Post

Alternative idea: Rewrite the dull default repo readme to include an ”awesome-minetest” style section of important community repos and web sites.
Mods | Support Mesehub: bc1qluuests9rxmlnvpjrhsnyjg9ucwy6z3r0y3srw

User avatar
rubenwardy
Moderator
Posts: 6153
Joined: Tue Jun 12, 2012 18:11
GitHub: rubenwardy
IRC: rubenwardy
In-game: rubenwardy
Location: United Kingdom
Contact:

Re: Modding Tutorial Book (new: Code architecture, unit test

by rubenwardy » Post

New Chapters!

Also added previous next chapter links, and changed a lot of the URLs.

User avatar
TumeniNodes
Member
Posts: 2853
Joined: Fri Feb 26, 2016 19:49
GitHub: TumeniNodes
IRC: tumeninodes
In-game: TumeniNodes
Location: in the dark recesses of the mind
Contact:

Re: Modding Tutorial Book (new: Code architecture, unit test

by TumeniNodes » Post

rubenwardy wrote:

New Chapters!

Also added previous next chapter links, and changed a lot of the URLs.
Next: Point all wiki dev link to the modding book ; )
Ich mag keine grünen Eier und Schinken, ich mag sie nicht Sam I Am

cryptavian
New member
Posts: 1
Joined: Thu Sep 06, 2018 04:42

Re: Modding Tutorial Book (new: Code architecture, unit test

by cryptavian » Post

Is the IDE/Lua debugging section still accurate and up-to-date? At the very least I think server property "secure.enable_security false" needs to be set in order for the "require('debugger')" line to grab the correct module without triggering mod security exceptions.

After setting that and the subsequent steps, I still got the error that follows Lua Runtime error "module 'socket.core' not found" from within debugger.lua; does anyone know what I'm doing wrong?

Code: Select all

2018-09-06 04:36:55: ERROR[Main]: ServerError: AsyncErr: ServerThread::run Lua: Runtime error from mod 'mobs_monster' in callback LuaABM::trigger(): /usr/local/lib/lua/5.1/debugger.lua:53: module 'socket.core' not found:
2018-09-06 04:36:55: ERROR[Main]:       no field package.preload['socket.core']
2018-09-06 04:36:55: ERROR[Main]:       no file './socket/core.lua'
2018-09-06 04:36:55: ERROR[Main]:       no file '/usr/local/share/lua/5.1/socket/core.lua'
2018-09-06 04:36:55: ERROR[Main]:       no file '/usr/local/share/lua/5.1/socket/core/init.lua'
2018-09-06 04:36:55: ERROR[Main]:       no file '/usr/local/lib/lua/5.1/socket/core.lua'
2018-09-06 04:36:55: ERROR[Main]:       no file '/usr/local/lib/lua/5.1/socket/core/init.lua'
2018-09-06 04:36:55: ERROR[Main]:       no file './socket/core.so'
2018-09-06 04:36:55: ERROR[Main]:       no file '/usr/local/lib/lua/5.1/socket/core.so'
2018-09-06 04:36:55: ERROR[Main]:       no file '/usr/local/lib/lua/5.1/loadall.so'
2018-09-06 04:36:55: ERROR[Main]:       no file './socket.so'
2018-09-06 04:36:55: ERROR[Main]:       no file '/usr/local/lib/lua/5.1/socket.so'
2018-09-06 04:36:55: ERROR[Main]:       no file '/usr/local/lib/lua/5.1/loadall.so'
2018-09-06 04:36:55: ERROR[Main]: stack traceback:
2018-09-06 04:36:55: ERROR[Main]:       [C]: in function 'require'
2018-09-06 04:36:55: ERROR[Main]:       /usr/local/lib/lua/5.1/debugger.lua:53: in main chunk
2018-09-06 04:36:55: ERROR[Main]:       [C]: in function 'require'
2018-09-06 04:36:55: ERROR[Main]:       /path/to/minetest/bin/../mods/mobs/api.lua:3212: in function </path/to/minetest/bin/../mods/mobs/api.lua:3211>
Here are the steps I followed from: https://rubenwardy.com/minetest_modding ... vironments
IDEs allow you to debug code like a native application. These are harder to set up than just a text editor.

One such IDE is Eclipse with the Koneki Lua plugin:
  • Install Eclipse + Koneki.
    Create a new Lua project from existing source (specify Minetest’s base directory).
    Follow instructions from Koneki wiki how to do “Attach to remote Application” debugging (just a few steps).
    It is suggested to add those lines from wiki at beginning of builtin.lua.
    Start the debugger (set “Break on first line” in debugger configuration to see if it is working).
    Start Minetest.
    Enter the game to startup Lua.
EDIT - Update

I resolved this issue by running "luarocks install luasocket" which downloaded and installed the appropriate socket library onto my system's Lua path thanks to help on Discord from rubenwardy and others. Debugging through Eclipse Koneki works great now!

User avatar
Kilarin
Member
Posts: 778
Joined: Mon Mar 10, 2014 00:36

Re: Modding Tutorial Book (new: Code architecture, unit test

by Kilarin » Post

Just wanted to add my voice to the other saying that this book is AWESOME and very helpful. THANK YOU!

User avatar
FrostRanger
Member
Posts: 25
Joined: Thu Oct 11, 2018 05:40
GitHub: WulftheNordicRanger
IRC: FrostRanger FrostRanger[m]
In-game: FrostRanger FrostStar
Location: In the untamed wilderness of wherever I happen to be dimension hopping this time...

Re: Modding Tutorial Book (new: Code architecture, unit test

by FrostRanger » Post

Koneki does not seem to be in the eclipse marketplace (well, it is, but it is not for lua though). The only thing that seems to be available for lua in the eclipse marketplace is Lua Development Tools. Just staring out with modding so I haven't had a chance to play around with it much but it seems to work fine. Thank you for making this awesome resource!
Sole ranger and ruler of the frozen realms of Cabin Fever and seeker of the ever elusive Dungeon Master...

User avatar
markthesmeagol
Member
Posts: 33
Joined: Fri Dec 21, 2018 13:15
GitHub: smeagolthellama
In-game: haivets

Re: Modding Tutorial Book (new: Code architecture, unit test

by markthesmeagol » Post

I have a bit of a complaint. The games chapter seems rather lacking. Are there any other resources on making games?
I am not very good at lua. I am learning though.

User avatar
rubenwardy
Moderator
Posts: 6153
Joined: Tue Jun 12, 2012 18:11
GitHub: rubenwardy
IRC: rubenwardy
In-game: rubenwardy
Location: United Kingdom
Contact:

Re: Modding Tutorial Book (new: Code architecture, unit test

by rubenwardy » Post

markthesmeagol wrote:I have a bit of a complaint. The games chapter seems rather lacking. Are there any other resources on making games?
Making games in Minetest is basically just writing a load of mods. What exactly would you find useful to read about?

There's also this topic, which was created today: viewtopic.php?f=49&t=22932

User avatar
markthesmeagol
Member
Posts: 33
Joined: Fri Dec 21, 2018 13:15
GitHub: smeagolthellama
In-game: haivets

Re: Modding Tutorial Book (new: Code architecture, unit test

by markthesmeagol » Post

Well, to start off, a summary of what each file is, especially minetest.conf and settingstypes.txt. Also, something about where one should go to get a default mod. Minetest-game's default is a bit bloated, and writing my own from scratch isn't very appealing.

Also, since most games contain a number of third-party mods, it might be a good idea to give instructions on how to check licenses and stuff for compatibility issues, or worse.

Another thing that might be nice would be a list of commonly used, high-quality mods, that would be recommended for consideration in the interests of inclusion.
I am not very good at lua. I am learning though.

Post Reply

Who is online

Users browsing this forum: No registered users and 3 guests