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

User avatar
Lone_Wolf
Member
 
Posts: 2193
Joined: Sun Apr 09, 2017 05:50
Location: Hopefully very far from yours, snoop :P
GitHub: LoneWolfHT
IRC: Lone_Wolf
In-game: Lone_Wolf

Re: Modding Tutorial Book (new: Privileges)

by Lone_Wolf » Fri Oct 20, 2017 03:07

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: 982
Joined: Mon Jul 07, 2014 01:14
GitHub: Napiophelios
IRC: Nappi
In-game: Nappi

Re: Modding Tutorial Book (new: Privileges)

by Napiophelios » Fri Oct 20, 2017 03:21

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: 2193
Joined: Sun Apr 09, 2017 05:50
Location: Hopefully very far from yours, snoop :P
GitHub: LoneWolfHT
IRC: Lone_Wolf
In-game: Lone_Wolf
 

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

Re: Modding Tutorial Book (new: BasicMapOps, AutoErrorChecki

by rubenwardy » Sun Feb 25, 2018 00:07

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: 596
Joined: Thu Oct 13, 2016 10:45
Location: DE

Re: Modding Tutorial Book

by hajo » Sun Feb 25, 2018 23:00

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
Location: SW Florida, USA
In-game: Knatt

Re: Modding Tutorial Book (new: BasicMapOps, AutoErrorChecki

by KCoombes » Wed Feb 28, 2018 01:53

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

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

WHY?

by Wuzzy » Tue Apr 03, 2018 16:19

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

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

Re: Modding Tutorial Book (new: BasicMapOps, AutoErrorChecki

by MineYoshi » Sat Apr 28, 2018 01:28

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?
 

User avatar
muhdnurhidayat
Member
 
Posts: 295
Joined: Wed Nov 16, 2016 22:55
Location: Shah Alam, Selangor, Malaysia
GitHub: MuhdNurHidayat
IRC: muhdnurhidayat
In-game: muhdnurhidayat

Re: Modding Tutorial Book (new: BasicMapOps, AutoErrorChecki

by muhdnurhidayat » Sun Apr 29, 2018 22:12

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, contributing to Minetest Wiki. I'm muhdnurhidayat in IFS (mod), HOMETOWN & others. / Twitter / MT Offtopic ✂️- - - - - -

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: 5371
Joined: Wed Jul 08, 2015 13:20

Re: Modding Tutorial Book (new: BasicMapOps, AutoErrorChecki

by MineYoshi » Wed May 02, 2018 00:33

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. :-)
 

User avatar
Wuzzy
Member
 
Posts: 3625
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 » Sat Jun 02, 2018 21:59

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: 2827
Joined: Fri Feb 26, 2016 19:49
Location: in the dark recesses of the mind
GitHub: TumeniNodes
IRC: tumeninodes
In-game: TumeniNodes

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

by TumeniNodes » Sat Jun 02, 2018 22:24

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: 1588
Joined: Mon Jul 11, 2016 21:08
GitHub: tacotexmex
In-game: texmex

Re: Modding Tutorial Book (new: BasicMapOps, AutoErrorChecki

by texmex » Sat Jun 02, 2018 23:45

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

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

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

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

by TumeniNodes » Sun Jul 15, 2018 23:10

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 » Thu Sep 06, 2018 04:51

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!
 

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

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

by Kilarin » Fri Sep 14, 2018 16:37

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

FrostRanger
Member
 
Posts: 10
Joined: Thu Oct 11, 2018 05:40
Location: A frozen Realm in another dimension
GitHub: WulftheNordicRanger
IRC: FrostRanger
In-game: FrostRanger

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

by FrostRanger » Wed Nov 07, 2018 11:35

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!
Protector and sole ranger of the frozen realms and seeker of the ever elusive Dungeon Master
 

markthesmeagol
Member
 
Posts: 19
Joined: Fri Dec 21, 2018 13:15
GitHub: smeagolthellama

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

by markthesmeagol » Sun Jul 28, 2019 16:23

I have a bit of a complaint. The games chapter seems rather lacking. Are there any other resources on making games?
 

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

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

by rubenwardy » Sun Jul 28, 2019 16:27

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
 

markthesmeagol
Member
 
Posts: 19
Joined: Fri Dec 21, 2018 13:15
GitHub: smeagolthellama

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

by markthesmeagol » Sun Jul 28, 2019 17:30

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.
 

Previous

Return to Modding Discussion



Who is online

Users browsing this forum: No registered users and 1 guest