[Tool][MlSideQuests][1.014] Create your own quests in your maps

Talk about the track editor here

Moderator: English Moderator

Post Reply
User avatar
Harest
Posts: 130
Joined: 26 Mar 2018, 04:21
Contact:

[Tool][MlSideQuests][1.014] Create your own quests in your maps

Post by Harest » 14 Nov 2019, 12:01

Hellow,

If you're familar with RPG maps, you may have seen some side quests here and there. Most likely you never completed them, yet they're there for anyone wanting to try that out and extend the lifespan of the map currently played.

I was interested by this stuff for a map i was building for an upcoming event, so i asked, and Maxi031 gave me his script on which most quests are based if i'm not mistaken.
After many hours on all this, the v1.0 of MlSideQuests is there. See download link(s) below.

To clarify what MlSideQuests does: It allows you to add quests inside your maps, or more specifically, to keep track of the players who completed these quests as the rest is managed by the MediaTracker.

Everything you need should be in the .zip archive. Start with the README.md.
It's coded in PHP/MySQL. And how it works is that you put some MediaTracker clips in your map that will call a Manialink which will load a ManiaScript.
Initially the script used MySQLi, i switched to PDO. I also integrated a cache system called Memcached that i use on my own server.

I can't promise anything on the tool evolution, like a better way to create your quests (web admin), etc. Maxi031 was maybe interested to integrate some theming for the window and such. It may or may not happen.
If you want to improve the tool yourself, it's also possible. I'd appreciate you to share it also. You can do so on GitHub.

Enjoy!

Little tip: You can Ctrl+G to see the logs. By default, if you're the author of the map, you'll always be in debug mode. Otherwise nothing is logged for players except for the quest completion request result.
Additional note: It works in ShootMania too.

Download link(s): Releases on GitHub.

Changelog:
  • 2019-12-24 - v1.014:
    • Now possible to sort the players list who completed a quest also by best/first completion time.
    • Added a little ML function to display map name & display cost in the top left corner (can be useful for making of).
    • A few minor fixes, to avoid any style propagation (like italic) from the quest description for instance.
    • [Minor] Display hours in completion times.
  • 2019-12-02 - v1.013 - In ShootMania Obstacle, you can jump to any CP you want. We cancel the quest if any jump is made during it.
  • 2019-12-02 - v1.012:
    • Minor check on QuestInfo empty
    • SM (Obstacle only?) has a bug where a MT Clip X triggered also triggers the MT Clip X-1 previously triggered (if it exists) at the same time. We now prevent any position overwrite for the quests to work.
    • Small update of the tokens table structure so Y positions can be negative as they're underground. You may need to do a small SQL migration, see migration file migrating_v1010_to_v1012.sql in _private.
  • 2019-11-24 - v1.011:
    • Using the moment the player clicked on "start quest button" for instance could lead to the player letting the window open until being close to a token. (Race)StartTime taken instead.
    • Refactored the times formatting for the board a bit.
    • URLEncoding Username.
  • 2019-11-24 - v1.01 - Now register the time a player takes to complete a quest. If the player beats his/her PB, it's also updated.
  • 2019-11-19-2019-11-23 - v1.003:
    • A little precision on what MlSideQuests does really, added in the README intro.
    • Minor fix on the $_SERVER used in a check which has the wrong name to constitute the urls to request.
    • The block size of the EditorPlugin was still set on Canyon blocks. It now adapts itself with the environment you're in.
    • Added a little script as manialink: "MLSideQuests?DisplayPosition=1" to get the current player position, useful while mapping your quests for the right tokens positions.
  • 2019-11-16 - v1.002 - No need to edit the script anymore to set your own URLs for the few requests made by the script. It's automatically handled. Also updated the readme a bit to cover how it works exactly and what's possible.
  • 2019-11-15 - v1.001 - Update of the readme and Main.php to make it work in ShootMania. You only need to add "&SM=1" in the manialink calls.
  • 2019-11-14 - v1.0 - Release of the v1.0.
I chose this forum because i'm not really sharing a Manialink nor a dedicated server tool, nor a ManiaScript. It's adressed to any map creator, so i think its best place is in there.
Last edited by Harest on 24 Dec 2019, 07:20, edited 23 times in total.

User avatar
Alinoa
Nadeo
Nadeo
Posts: 4632
Joined: 14 Jun 2010, 11:55
Location: France, Paris
Contact:

Re: [Tool][MlSideQuests][1.0] Create your own quests in your maps

Post by Alinoa » 14 Nov 2019, 15:38

Hello Harest,

This looks like very fun :clap: :thumbsup:
I added your post as sticky.
Ubisoft Support
Your Player Page

More information about maniaplanet, support, contents, community activities: useful links

ManiaPlanet technical documentation portal (Dedicated server, Mediatracker, ManiaLink, ManiaScript, Titles...)

User avatar
Harest
Posts: 130
Joined: 26 Mar 2018, 04:21
Contact:

Re: [Tool][MlSideQuests][1.0] Create your own quests in your maps

Post by Harest » 14 Nov 2019, 17:07

Before starting my first map that will make use of it, i thought it was only for RPG maps and it had to do with something in the RPG TitlePack. Turns out it's not the case at all.
It indeed opens up quite a lot of possibilities, we may even say this is QuestMania pre-alpha inside TrackMania Image.

Thanks for the sticky :thx:.

User avatar
Miss
Posts: 2112
Joined: 05 Jan 2016, 11:34
Location: The Netherlands
Contact:

Re: [Tool][MlSideQuests][1.0] Create your own quests in your maps

Post by Miss » 14 Nov 2019, 17:17

Nice work, cool concept! :thumbsup:

Perhaps you should put everything on Github instead, so that people can easily contribute with pull requests and such. ;)
1070 GTX, Ryzen 3700X, 16GB RAM, Windows 10
Forum moderator, opinions are my own. :thx:
Check out Image openplanet, the alternative ManiaPlanet & Turbo scripting platform! (Openplanet subforum)
I also stream on Twitch and tweet on Twitter.

User avatar
Harest
Posts: 130
Joined: 26 Mar 2018, 04:21
Contact:

Re: [Tool][MlSideQuests][1.0] Create your own quests in your maps

Post by Harest » 14 Nov 2019, 17:27

@Miss: I was thinking about it indeed. But i'm always a bit too lazy to use Git locally ^^. If only the site would allow to do commits on multiple files (afaik you can only edit one file that will do one commit, nothing else :/, though you can probably squash if you're the owner, but yeah not practical outside of a locally handled Git).
I'll see.
Edit : Done. It was already a mess with the readme ahah. I worked a while ago with Git, i always forgot the commands back then. But i'll just use the GitHub app i guess and if it's a mess, it's a mess.

User avatar
Miss
Posts: 2112
Joined: 05 Jan 2016, 11:34
Location: The Netherlands
Contact:

Re: [Tool][MlSideQuests][1.0] Create your own quests in your maps

Post by Miss » 14 Nov 2019, 19:34

This might be useful for you! https://www.codecademy.com/learn/learn-git
1070 GTX, Ryzen 3700X, 16GB RAM, Windows 10
Forum moderator, opinions are my own. :thx:
Check out Image openplanet, the alternative ManiaPlanet & Turbo scripting platform! (Openplanet subforum)
I also stream on Twitch and tweet on Twitter.

User avatar
Harest
Posts: 130
Joined: 26 Mar 2018, 04:21
Contact:

Re: [Tool][MlSideQuests][1.014] Create your own quests in your maps

Post by Harest » 24 Dec 2019, 07:51

Just a little message to say that since i posted that tool, it evolved a bit.
Very quickly it was working both for TrackMania² and ShootMania*. And in fact the first map using it is a ShootMania one, in the Obstacle TitlePack named sbvrooms by SBVille.

Updates were mostly small ones, though completion times were added in v1.01, and the latest update added sorting options (initially only ordered by first completion date, now you can sort by best/first completion time).
In there 2 small manialinks were added that are +/- related: one to display your position while mapping (useful when you set the tokens to be sure the EditorPlugin is working as intended with the positions it gives you) and one to display map name & display cost (for a basic making of for instance).

Since we're already the 24th, there's no surprise that my map will be released tomorrow, on December 25. Edit : Here's is CCP#25 - Manifold Island.
*On that note i'm not sure if we keep this thread in this TM² subforum or a more generic one like ManiaPlanet.

Post Reply

Return to “Track Editor”

Who is online

Users browsing this forum: No registered users and 1 guest