The purpose of this page is to give a link to all kinds of resources that contain information valuable to current and future developers of ScummVM.
- The first thing you need to be able to do is get the ScummVM code from our Git repository.
- Then you should compile ScummVM.
That was easy, right? Here are some more tips:
- Some hints on debugging ScummVM.
- Before you write/submit code, you must read about our Code Formatting Conventions. Patches which do not follow them will be rejected or at least delayed until they are cleaned up to comply to them.
- Also, you should read and respect the general Coding Conventions.
- If you have write access to our repository, you are expected to have read and to comply with our Commit Guidelines. Also, read up on the Git tips.
- If you do not have write access, you should use our patch tracker to submit your contributions.
- Our Doxygen source code documentation may help you to get the big picture about ScummVM.
- Also, you might want to check our list for current Platform Limitations.
- If you want to provide a new Engine for ScummVM, check out our Engines HOWTO.
- If you work on a game engine for ScummVM, consider implementing Advanced Engine Features.
- If your engine supports multiple games / game variants, properly detecting and differentiating them all can be a nuisance. Use the Advanced Detector to overcome this hurdle.
- Accessing files in a portable fashion is non-trivial. Read all about how to open files.
- If you want to have your engine merged into the ScummVM mainline, check out our Engine Inclusion HOWTO.
- If you want to port ScummVM to a new platform, check out our Backends HOWTO.
- The Dynamic Modules HOWTO describes how to implement loadable modules on a smaller backend, even without operating system support.
For Web site maintainers
- If you want to update the main web site, update the files you want in /web trunk, and then login to the SF shell, change to the directory /home/project-web/scummvm/htdocs/ and run ./update.sh. To use the Interactive Shell Service of sf.net, check this tutorial
Projects, plans, things to do
We are usually happy to receive any kind of help with the things listed below.
- List of open tasks, with relatively detailed descriptions, and contact points. Some rather small ones, some bigger ones, take a look. GSoC Ideas also has some ideas, intended for students applying for Google's Summer of Code.
- Main TODO list (contains links to many further specialized TODO pages, e.g. for specific engines).
- Our bug tracker lists bugs that need to be resolved
- Our feature request tracker also lists features requested by all kinds of people.
The following are partially outdated, but kept for now for the sake of reference.
- Small Devices Backend -- this was under development as part of the GSoC, but additional help is welcome.
- Keymapping Improvements -- still in the design stage. Help is welcome.
- Music drivers redesign -- in phase of discussion
Our "new" GUI is themeable and translatable. If you are interested in writing a custom theme, the following may be of help for you:
- Our release guideline for ScummVM Release HOWTO
- Our release testing status for the latest stable release Release Testing
Our commit logs are fed to several freely available statistics tools:
- ohloh project analysis nice graphs and devs activity
- CIA.vc statistics, current development
- GitHub page, current development on github
Team Member Benefits
Every active ScummVM Team member is eligible for enhanced access to our Project Services and some further benefits:
- being added to our main credits (do it by yourself in scummvm/devtools/credits.pl)
- @scummvm.org forwarding address
- operator status in our IRC Channel #scummvm @ freenode
- address cloak on freenode (in form of scummvm/undead/nick)
- moderator status on ScummVM Forums and appropriate badge "ScummVM Developer" or "ScummVM Porter" or special one
- ScummVM Wiki account
- having development blog displayed on ScummVM Planet
- using project donations for purchasing necessary things for the development, such as game copies, software licenses, etc.
If you need any of the above, talk to sev.