[TUTORIAL] Add ZONE function

[SweetSea-ButImNotSweet]

I know when I open this discussion, the game still in heavily development, so I CAN'T make sure everything will be okay through updates

HOW TO ADD ZONE FUNCTION INTO GAME MODE?

Honestly there are some requirements (very eazy):

• You should know a little of coding (just make sure that you will not make any dumb questions while modding 😅)
• You have to run the game from source code, otherwise if you are running built version (which can be downloaded from Action then you can't modding it)

If you meet these requirements then we will go to next step

1. First open /assets/game/mode/mino
   Ex: if you put the game in D:\Techmino_Galaxy\ then you will open D:\Techmino_Galaxy\assets\game\mode\mino (on Windows)
   The path may different depends on platform which you are using

2. Now open a game mode file which you want to add Zone function
   Ex: if you want to add Zone function into Marathon mode then edit marathon.lua
   You can open it with Notepad because they are plain text 😸
   
   Note: For Android: if your file manager tell that there is no app to open, you can download a code editor (ex: Pocket Editor) then open the app and open the code file inside

3. Edit time
   UPDATE: Now it's easier to make, just by editing something like:

eventsets={
    -- Some codes will go here
+    "P:setAction('func1',mechLib.mino.stack.switch_auto)",
    -- More code will go here, maybe?
}

Since old tutorial still working, I will keep it here for who want to make a mode with advanced choices

---

In this tutorial, I will pick Sprint 200 mode file as example:

local bgmTransBegin,bgmTransFinish=100,150

return {
    initialize=function()
        GAME.newPlayer(1,'mino')
        GAME.setMain(1)
        playBgm('race','base')
    end,
    settings={mino={
        event={
            playerInit=mechLib.mino.statistics.event_playerInit,
            afterClear={
                mechLib.mino.statistics.event_afterClear,
                mechLib.mino.sprint.event_afterClear[200],
                function(P)
                    if P.modeData.line>bgmTransBegin and P.modeData.line<bgmTransFinish+4 and P.isMain then
                        BGM.set(bgmList['race'].add,'volume',math.min((P.modeData.line-bgmTransBegin)/(bgmTransFinish-bgmTransBegin),1),2.6)
                    end
                end,
            },
            drawInField=mechLib.mino.sprint.event_drawInField[200],
            drawOnPlayer=mechLib.mino.sprint.event_drawOnPlayer[200],
        },
    }},
}

We will add this into playerInit. But how?

function(P) P:setAction("func1",mechLib.mino.stack.switch) end,

Yea, I know someone may ask me. Remember this is Lua code, and we can't do something like:

playerInit=mechLib.mino.statistics.event_playerInit, function(P) P:setAction("func1",mechLib.mino.stack.switch) end,

It will return an error like this

It's not funny to see this. So how to fix
We will need to make an list this time
In Lua, this is how you make a list:

a_list = {"item 1", "item 2"}

So in this case we will do like this

playerInit={
    mechLib.mino.statistics.event_playerInit,
    function(P) P:setAction("func1",mechLib.mino.stack.switch) end,
},

Let me explain: P:setAction("func1",mechLib.mino.stack.switch) will assign the Function 1 (F1) key to Stack switch (which you can turn on/off Stack (Zone) mode
Note: if it is a list already then just add function(P) P:setAction("func1",mechLib.mino.stack.switch) end, right after the last item
One more thing you should remember, if you see something like:

playerInit={
    -- Some codes will goes here
    function(P)
        -- Some codes will goes here
    end
}

Then just add like this

playerInit={
    -- Some codes will goes here
    function(P)
        -- Some codes will goes here
+       P:setAction("func1",mechLib.mino.stack.switch)
    end
    -- More code will goes here
}

Next, we will add this into afterLock:

mechLib.mino.stack.event_afterLock,

You may notice there is no afterLock in the code right? Well, we can just make thing simple, don't need to make a list

afterLock = mechLib.mino.stack.event_afterLock,

Finally, you should add this:

whenSuffocate=mechLib.mino.stack.event_whenSuffocate,

This is very important because it will trigger when you are "BLOCK OUT!" (it will turn the Zone switch off, clear all stacked lines)


If you have done 3 steps above, then the code should be like this

local bgmTransBegin,bgmTransFinish=100,150

return {
    initialize=function()
        GAME.newPlayer(1,'mino')
        GAME.setMain(1)
        playBgm('race','base')
    end,
    settings={mino={
        event={
-           playerInit=mechLib.mino.statistics.event_playerInit,
+           playerInit={
+              mechLib.mino.statistics.event_playerInit,
+              function(P) P:setAction("func1",mechLib.mino.stack.switch) end,
+           },
            afterClear={
                mechLib.mino.statistics.event_afterClear,
                mechLib.mino.sprint.event_afterClear[200],
                function(P)
                    if P.modeData.line>bgmTransBegin and P.modeData.line<bgmTransFinish+4 and P.isMain then
                        BGM.set(bgmList['race'].add,'volume',math.min((P.modeData.line-bgmTransBegin)/(bgmTransFinish-bgmTransBegin),1),2.6)
                    end
                end,
            },
            drawInField=mechLib.mino.sprint.event_drawInField[200],
            drawOnPlayer=mechLib.mino.sprint.event_drawOnPlayer[200],
+           afterLock = mechLib.mino.stack.event_afterLock,
+           whenSuffocate=mechLib.mino.stack.event_whenSuffocate,
        },
    }},
}

Now you will see you can turn on or off Zone by pressing Function 1 (F1) key any time you want
https://user-images.githubusercontent.com/106439598/231941398-d2941aa0-5126-48e4-9e9f-77336d8bf08a.mp4

But we still need a thing: animation for the number
You will have to add mechLib.mino.stack.event_always_animated and mechLib.mino.stack.event_drawOnPlayer_animated into the drawOnPlayer

It should be like this:

-           drawOnPlayer=mechLib.mino.sprint.event_drawOnPlayer[200],
+           drawOnPlayer={mechLib.mino.sprint.event_drawOnPlayer[200], mechLib.mino.stack.event_always_animated, mechLib.mino.stack.event_drawOnPlayer_animated},

Finally the new code will be like this

local bgmTransBegin,bgmTransFinish=100,150

return {
    initialize=function()
        GAME.newPlayer(1,'mino')
        GAME.setMain(1)
        playBgm('race','base')
    end,
    settings={mino={
        event={
            playerInit={
                mechLib.mino.statistics.event_playerInit,
                function(P) P:setAction("func1",mechLib.mino.stack.switch) end,
            },
            afterClear={
                mechLib.mino.statistics.event_afterClear,
                mechLib.mino.sprint.event_afterClear[200],
                function(P)
                    if P.modeData.line>bgmTransBegin and P.modeData.line<bgmTransFinish+4 and P.isMain then
                        BGM.set(bgmList['race'].add,'volume',math.min((P.modeData.line-bgmTransBegin)/(bgmTransFinish-bgmTransBegin),1),2.6)
                    end
                end,
            },
            drawInField=mechLib.mino.sprint.event_drawInField[200],
            drawOnPlayer={mechLib.mino.sprint.event_drawOnPlayer[200], mechLib.mino.stack.event_always_animated, mechLib.mino.stack.event_drawOnPlayer_animated},
            afterLock = mechLib.mino.stack.event_afterLock,
            whenSuffocate=mechLib.mino.stack.event_whenSuffocate,
        },
    }},
}

---

After done this, you can experience Zone in Sprint 200
You can apply this tutorial to any mode you want, remember you may have to modify some depends on mode you are modding

Here is my run for 200 lines with Zone (no video now)

Enjoy, Zone - no time limit

[SweetSea-ButImNotSweet]

Ok, even I though I can touch the checkbox which is not edit anything. Bruh