Manual
The manual from learning how to contribute to the project, to the rules of it! It'll be kept short and simple, since it's only a one page thing!
If you are only here to learn how to create your own texture pack, skip to section 2!
Anyone is able to contribute to this project, the only catch is whether or not you can contribute, if you know how to contribute and are certain you will not mess up in a commit.
I will only permit commits that add new textures to be pushed once they're properly implemented and tested.
You can join the project by simply contacting my Discord. AkiraJkr#6764
-
Firstly, of course you'll need a Git software, it's the basics if you're working on GitHub with things. You can get one software here: https://gitforwindows.org/
-
Now that you finally have it, you're probably wondering what you have to start. First, you gotta start the GUI. You'll be greeted with a window similar to this. Probably not at the first start, but you may.
You'll want to click on Clone Existing Repository so you can download this repo to your computer with all of it's contents. You'll be presented with two things, once you set them, you are done, and you can start adding things.
Source Location: This is basically the link of the repository you'll clone. Just take it. Easy.
Target Directory: Where you want to drop all of the contents in the repo. In the case of this repository, you'll want to go to the PSP/TEXTURES folder and make the game's folder with it's ID, and use it as the source location.
Once that's done, you'll have it begin download, and then, it's all there, ready to work with.
So, you're still confused about how Git GUI works, and want a faster way to work with it? Download TortoiseGit! After you're done downloading and installing, make sure you open it's settings(Just right-click any file you see, TortoiseGit/Settings) then go to the Icon Overlays category, and in Status Cache, select None. That way, your performance won't be degrading while using and NOT using TortoiseGit.
-
Now it's time to start working! I bet you're eager to add textures, but not yet! Firstly, there is something important to do it doesn't work by simply copy and pasting the contents. Firstly, you go in-game, reach the section with the textures you want to modify, if it's not already in the folder, by enabling the Save new textures on the Developer Tools, they'll get dumped in a folder called new. Take those dumped textures to the rightful category, or create a new one if there's not a proper one. EX: Weapons/Guns or Weapons/Melee, etc.
-
Now, you may notice it has a bunch of weird numbers as the name of the files, correct? The correct procedure is copying these numbers and adding them to the .ini, properly sorted of course. A recommended course of action after that is getting rid of the first 8 numbers by adding 8 ceros. That way, the textures are able to load whenever they appear and reappear.
"But hey, this texture still refuses to stay changed once they reappear or are modified!" The scenario for this comes when the texture has a CLUT, to identify a CLUT, you just have to find a bunch of random scrabbled things around the real thing that gets changed in-game, for example in a texture like this. But there's nothing wrong in that texture, you ask. Well, that's because I got rid of the texture, but that's not enough, you may notice it starts not working COMPLETELY after you remove the weirdness. That's because you also have to remove the last 8 ceros of the texture's name.
In the end, it may look like something similar to this:
0000000048406c2000000000
The textures will still not work yet though! For it to begin working, you have to input the path where that can be found, and meanwhile, you can also rename it. You only have to input the path INSIDE the folder of the game's textures, plus include the texture name. For example...
0000000048406c2000000000 = Menus\In-game Menu.png
And thus, that's sorted, you now know how to add textures to work in the game, and you may see the changes of your work, don't forget to turn off Save new textures so you don't overload with dumped textures!
There are a few rules that apply to these things that are worth noting:
- Do not mess with the texture transparency if it has any, or you may risk breaking it in-game too.
- Do not change the aspect ratio, shape or form of the texture, if it looks weird, keep it like it. It's how it works. If you're gonna scale/make it bigger, DO NOT CHANGE THE ASPECT RATIO.
- Now that you made the changes, you wanna push them to GitHub, simply open Git GUI, if the files you've changed/added are not listed in Unstaged Changes, do a Rescan. Once that's done, click Stage Changed, and write a message or something about what was changed, or something similar. And to be done with this, Commit your changes and succesfully push them to the master branch, and you're done! Changes are avaiable to download and test!
Every game is different and works differently. Learn more about texture replacement by yourself, some games may behave badly with a hash method, some may don't. For others, it may be optimal. It all depends on YOUR attempt on learning.