A FAQ would be awesome

[Xerner]

Reviewing the discord chat reveals that many of the same questions are asked and answered over and over. A linkable FAQ would be great

[Xerner]

Heres a start

FAQ

• Is Pokemon Unity still in development?
  • Yes
• Is the Unity part of this project being worked on?
  • No
• Is there a more up to date version and runnable version of this?
  • Not that we know
• How do I start developing my own Pokemon game?
  • Thats completely up to you. The maintained Pokemon code in this repository is actually NOT related to Unity at all. This means someone can take the code here and start their own Pokemon game in any way that supports loading C# DLL libraries. Unity is just 1 way :)
• What relevance do the folders other than the Pokemon Unity folder have?
  • The repo contains several projects. Each folder (probably) represents one of those projects. The Pokemon Unity folder is just where the Unity related files are found
    • TODO: add breakdown of contents of each parent folder

Unity FAQ

• Why is my screen pink?
  • Unity metafiles were broken sometime in the past. Because of this, images in (probably) all scenes are corrupted and show up pink
• How do I learn Unity?
  • There are several great tutorials on YouTube to learn Unity. To name a few
    • Brackeys
    • Code Monkey
    • Jason Weimann
    • Unity
    • Sebastian Lague
    • Game Maker's Toolkit
• Why isnt the Unity side of things being worked on?
  • There is only 1 developer currently active on this project. Their focus is on the non-Unity Pokemon framework

[herbertmilhomme]

Why is my screen pink?

The answer can be a pretty lengthy one, but it's just a unity issue with the .meta files. The why, the how, and the solution is discussed here:

https://discord.com/channels/285560546244427777/285565647507685379/1046810010132435067

[herbertmilhomme]

Why isnt the Unity side of things being worked on?

I wouldnt say it's because i'm the only dev, but that we dont have any "Unity-developers", it's way more appealing to write programming code, than to struggle with getting unity to behave nice. Those that are comfortable with unity, are mostly working on their own private projects... It's not easy to manage a unity project in git, as there's lots of problems that occur just on the .meta files, if the team isnt in sync or on the same page, in terms of development style/practice, and communication (overlapping edits in the same scene, across different commits can cause major problems when a conflict emerges).

At the end of the day... the project is geared more towards being an API framework, than a game kit (a playable unity demo/sample used as a foundational resource to start you game from).

[herbertmilhomme]

How to download?

This is a Github question, not really specific to project. But since a lot of people new to the project are also new to github, i recommend just reading this guide and following the steps. Better than downloading a zip, and the frustrations that come after from not receiving bug fixes and updates.

https://docs.github.com/en/desktop/contributing-and-collaborating-using-github-desktop/adding-and-cloning-repositories/cloning-a-repository-from-github-to-github-desktop

or...

https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository

Downloading zips aren't always the answers because some files don't get moved over into zip
There are settings on some projects on repository to limit what will and will not go into a "zip" download. Though I don't believe I'm using those settings...
When you clone a project, it bypasses those settings and gives you a one-for-one copy of the project and all of its contents
Literally, "cloning" instead of downloading a "package"

This was an answer i gave to a user in discord chat. But when you "clone" the project, the project lives on your computer as well as on the git cloud it came from... so if a problem is "fixed" on the server, you dont need to download the entire project over again just for the files that were corrected (also, you dont need to worry about your changes be lost or deleted). If you make any edits and want to share it with the project for others to download, then this is also the same steps needed in order to do that.

[herbertmilhomme]

I downloaded the Github, like instructed above, but how do i play it? I want to experience a pokemon game inside unity...

This isnt a game kit, nor a pokemon clone. It's a resources for your game to implement pokemon features (like a plug-in or API). The resources are downloaded assets you can add to your existing or new project, and shortcut the need to have to program all the pokemon logic yourself from zero. This is a transferrable drag-and-drop library, and for the time being, there really isnt any flagship game to showcase or demo the content in usage. (Unless you wish to be the first, and link back to us here, for us to tag you... no one contributing back to this repository is a "game developers" 🤷 )

[herbertmilhomme]

What about the youtube video that i saw, where the game was running in unity? How do i download and play that?

That's found in the release tab, as an .exe download...
https://github.com/PokemonUnity/PokemonUnity/releases
you can grab the project that was created by the original author of this project repository. But it's dated back to 2015, and has a lot of incomplete code that we're attempting to resolve by rewriting and redoing the code source from the ground up. So if you want the latest changes and fixes, there is no "game" to play; and yes... you will download a git repository with a unity project that may contain a lot of errors (preventing you from playing any scene).