Grasscutter/README_fil-PH.md

EN | 简中 | 繁中 | FR | ES | HE | RU | PL | ID | KR | FIL/PH | NL | JP

Atensyon: Ang mga kontributor ay laging welcome sa proyektong ito. Bago mag-bigay ng kontribusyon, basahin muna ng mabuti ang Code of Conduct.

(Basahin ha, hindi titingin lang)

Ang mga current features

• Login system
• Combat
• Friends list
• Teleportation
• Gacha system
• Co-op partially works
• Spawning monsters via console
• Inventory features (receiving items/characters, upgrading items/characters, etc)

Quick setup guide

Atensyon: Kung di mo talaga kaya o hindi mo maintindihan ang wiki, maaari kang sumali sa aming server Discord.

Ang mga kailangan

• Java SE - 17 (link)

  Atensyon: Kung gusto mo lang paganahin ang server, then jre is pwede naman.

• MongoDB (recommended 4.0+)

• Proxy daemon: mitmproxy (mitmdump, recommended), Fiddler Classic, etc.

Running

Atensyon: Kung nag-update ka galing sa old version, paki-delete ang config.json para mag-regenerate ulit.

1. Get grasscutter.jar
   • Download ka from actions
   • Build mo ung jar by yourself
2. Gawa ka ng resources folder sa directory kung nasaan ang grasscutter.jar at ilagay ang BinOutput at ExcelBinOutput sa loob ng resources folder (Check mo ang wiki para malaman mo san mo makukuha yan)
3. Paandarin ang Grasscutter gamit ang command na java -jar grasscutter.jar. Make sure na gumagana ang mongodb (Google mo nalang kung pano mo malalaman)

Connecting with the client

½. Create ka ng account gamit ang server console command.

1. Redirect traffic: (choose one)

   • mitmdump: mitmdump -s proxy.py -k

     Trust CA certificate:

     ​ Note: Usually ang CA certificate ay nakalagay sa %USERPROFILE%\ .mitmproxy, o pwede mo naman i-download from http://mitm.it

     ​ Double click para ma-install or ...

     • Gamit ang command line (cmd.exe)

       certutil -addstore root %USERPROFILE%\.mitmproxy\mitmproxy-ca-cert.cer
       

   • Fiddler Classic: Paadarin ang Fiddler Classic, tsaka turn on mo yung Decrypt https traffic sa settings at baguhin mo yung default port na nakalagay (Tools -> Options -> Connections) to anything other than 8888, at saka mo i-load itong script.

   • Hosts file

2. Set mo ung proxy sa 127.0.0.1:8080 or dun sa proxy port na iyong inilagay.

pwede mo rin gamitin ang start.cmd to start the servers and proxy daemons automatically, pero kailagan mong i-setup ang JAVA_HOME enviroment

Building

Ang Grasscutter ay gumagamit ng gradle for depedencies at building.

Mga kailangan:

• Java SE Development Kits - 17
• Git

Windows

git clone https://github.com/Grasscutters/Grasscutter.git
cd Grasscutter
.\gradlew.bat # Setting up environments
.\gradlew jar # Compile jar

Linux

git clone https://github.com/Grasscutters/Grasscutter.git
cd Grasscutter
chmod +x gradlew
./gradlew jar # Compile jar

Pag-katapos mong i-compile, check mo yung project directory at saka makikita mo ung jar na kinompile mo. Usually pag-dev version, ang dapat nakalagay jan ay grasscutter-<version>-dev.jar. Bulag ka pag-hindi mo pa yan nakita.

Atensyon: ang mga server commands ay nasa wiki!

Quick Troubleshooting

• Kung hindi nag-compile, paki-check ung JDK installation mo (JDK 17 at JDK's bin PATH variable). Pag-hindi mo pa rin na-compile o hindi mo ma-gets, isa lang masasabi ko sayo, may skill issue+reading issue ka.
• Hindi ako maka-connect, ayaw mag-login, 4206, etc... - Usually proxy may kasalanan nyan, ito ung pinaka-malalang skill issue na pwede mong makuha, sa lahat ng problems sa gc. Kung ayaw mo nyan, basahin mo ito.

Kung Fiddler user ka, paki-sigurado na naka-set ung port sa kahit ano except sa 8888. (8888 port is for hoyoverse spider logs, in case na hindi mo alam)

• Startup sequence: MongoDB > Grasscutter > Proxy daemon o Proxy service (mitmdump, fiddler, etc.)

KUNG HINDI MO TALAGA MAINTINDIHAN, LUMAYAS KA NA DITO......... PUTANG INA MO, TAGLISH NA NGA YAN. TAS HINDI MO PA MA-GETS LMAO