WML Tutorial 2.0?
Moderator: Forum Moderators
Forum rules
- Please use [code] BBCode tags in your posts for embedding WML snippets.
- To keep your code readable so that others can easily help you, make sure to indent it following our conventions.
WML Tutorial 2.0?
Hey folks,
As I decided to actually seriously start a campaign in December 2021 (so I still have some time left ... I am doing some preparatory moves; I'll eventually publish all my findings on rubygems.org, when it comes to code, but this comes at a later time), I am wondering:
- Is there a TUTORIAL that works in a step-by-step fashion?
What I would need are EXAMPLES, working snippets. I am notoriously lazy but I learn best when there are small examples
that build up incrementally, so I can add on more knowledge. Such a tutorial would be great.
With snippets I mean things that can be isolated and tested in a small way, and from there build - perhaps ideally even do so within wesnoth directly but it is ok to work with text files too - the important part I'd be looking for here is to understand and learn in small steps. When I read a huge, long guide it tends to bore me quickly. I am notoriously multi-tasking so I totally mess my head up ... with short attention span. (But I also write down things once I understand it in a succinct way, so it helps me remember and learn. Hard to explain this mental model but perhaps some other folks can relate.)
As I decided to actually seriously start a campaign in December 2021 (so I still have some time left ... I am doing some preparatory moves; I'll eventually publish all my findings on rubygems.org, when it comes to code, but this comes at a later time), I am wondering:
- Is there a TUTORIAL that works in a step-by-step fashion?
What I would need are EXAMPLES, working snippets. I am notoriously lazy but I learn best when there are small examples
that build up incrementally, so I can add on more knowledge. Such a tutorial would be great.
With snippets I mean things that can be isolated and tested in a small way, and from there build - perhaps ideally even do so within wesnoth directly but it is ok to work with text files too - the important part I'd be looking for here is to understand and learn in small steps. When I read a huge, long guide it tends to bore me quickly. I am notoriously multi-tasking so I totally mess my head up ... with short attention span. (But I also write down things once I understand it in a succinct way, so it helps me remember and learn. Hard to explain this mental model but perhaps some other folks can relate.)
Re: WML Tutorial 2.0?
Maybe not what you're asking for, but these might help. Look for WML_Guide, FrankenWML, Wesnoth_Lua_Pack.
- Jarom
- Posts: 110
- Joined: January 4th, 2015, 8:23 pm
- Location: Green Isle, Irdya or Poland, Earth - I'm not quite sure
Re: WML Tutorial 2.0?
I got inspired by your post and I'm in progress of writing one. Expect first chapters soon. In the meantime, consult WML Guide or try copying from An Orcish Incursion.
Re: WML Tutorial 2.0?
I looked at WML for Complete Beginners is that the same as WML Guide?
Is there somewhere else to find WML guide?
Never mind, I found it--it is not a directory it is an add-on.
thanks
Is there somewhere else to find WML guide?
Never mind, I found it--it is not a directory it is an add-on.
thanks
- Jarom
- Posts: 110
- Joined: January 4th, 2015, 8:23 pm
- Location: Green Isle, Irdya or Poland, Earth - I'm not quite sure
Re: WML Tutorial 2.0?
OK, finished the tutorial that might be better: https://wiki.wesnoth.org/MakingCampaignInWML. Still in review stage, but I'm somewhat satisfied.
- Lord-Knightmare
- Discord Moderator
- Posts: 2343
- Joined: May 24th, 2010, 5:26 pm
- Location: Somewhere in the depths of Irdya, gathering my army to eventually destroy the known world.
- Contact:
Re: WML Tutorial 2.0?
Skimmed through the page and seems to be quite detailed. Good work! I have also pinned this to the modding channel of the discord since we get so many new authors asking there first.Jarom wrote: ↑November 25th, 2021, 5:18 pm OK, finished the tutorial that might be better: https://wiki.wesnoth.org/MakingCampaignInWML. Still in review stage, but I'm somewhat satisfied.
Creator of "War of Legends"
Creator of the Isle of Mists survival scenario.
Maintainer of Forward They Cried
User:Knyghtmare | My Medium
Creator of the Isle of Mists survival scenario.
Maintainer of Forward They Cried
User:Knyghtmare | My Medium
Re: WML Tutorial 2.0?
Well done!Jarom wrote: ↑November 25th, 2021, 5:18 pm OK, finished the tutorial that might be better: https://wiki.wesnoth.org/MakingCampaignInWML. Still in review stage, but I'm somewhat satisfied.
Re: WML Tutorial 2.0?
You have made a good start. I would like to comment on some confusing names. If you name stuff with WML in the name the user may think WML is required for WML code. FOO might be a better choices, similarly if you use the name scenario in a name for a scenario file the user may think the string scenario is required for a scenario name. You are not alone in this convention, I don't now how many oop guilds call objects, my_object.
I laude your efforts of course.
yours
winkr7
I laude your efforts of course.
yours
winkr7
- Jarom
- Posts: 110
- Joined: January 4th, 2015, 8:23 pm
- Location: Green Isle, Irdya or Poland, Earth - I'm not quite sure
Re: WML Tutorial 2.0?
Thanks for the feedback, for me it seems like a very weird issue that wouldn't affect most people, but it is a biased opinion since I'm a longstanding programmer, so we'll see. I can't easily replace WML_Tutorial because it was used a lot there, and I hope those who are slightly disoriented did follow my advice and downloaded some simple add-on for reference.
Well, if it keeps coming up, I guess I'll change it anyway.
Well, if it keeps coming up, I guess I'll change it anyway.