Summer of Code/GSoC Ideas 2022

From ScummVM :: Wiki
< Summer of Code
Revision as of 22:43, 20 February 2022 by Sev (talk | contribs) (→‎Infrastructure Tasks: added System for checking the game files integrity)
Jump to navigation Jump to search

If you'd like to get involved in ScummVM, we'd love to help you get started!

We've had a lot of successful student projects as part of Google's Summer of Code in previous years -- we hope to inspire you to work with us and (hopefully) add your own success.

We often get asks by participants with no experience with ScummVM whether they have the necessary skills to participate with us. The idea of GSoC is to introduce students to open source development, so we are not expecting you to have experience with ScummVM. You will have time during the application and community bonding periods to familiarize yourself with the project. The technical skills required to work with us varies from task to task. For any work on ScummVM, you'll probably need to already be comfortable with a basic level of C++. Some of the tasks might need more specialized knowledge (working on a 3D game engine may need you to understand some OpenGL and 3D math, and some engine tasks may require some assembly or reverse engineering knowledge); we give our thoughts about this alongside each suggested task, below.

Most importantly, we'd like you to join our community. There are many previous GSoC participants who are still involved in our project, and whether or not you participate as part of Summer of Code, we'd love for you to get involved too.

You should come to our Discord Server and introduce yourself in the #scummvm-gsoc channel! We're friendly, and it's often the easiest way to ask questions about the tasks and the code in general. The channel is the main form of everyday communication for the project, and there will almost always be developers there who can discuss your project ideas, answer questions and help out.

You can find more information about what we expect from you before you apply at GSoC Application.

Introduction

We have a list of potential tasks further down on this page, but before you look at them, perhaps you'd like to take a look at some of the successful projects from previous years! We encourage all of our students to maintain a blog during their summer work, which is a nice way to get some sense of what they accomplished.

One popular type of task is to improve our support for the games you love, whether this means a new game engine, or helping us to perfect an existing one.

Sometimes source code is available - in recent summers, students integrated code supporting games such as Sfinx (blog), The Prince and the Coward (blog) and Avalanche (blog) into ScummVM. In fact, our support for the Wintermute engine was not only started by a GSoC student (blog), who integrated the code into our tree, but also drastically improved by another student a year later (blog).

GSOC EMI.png GSOC zvision.png GSOC EMI asm.png

A more challenging (but hopefully rewarding) idea is to start (or continue) reverse engineering a game where no source is available. Two good examples are the pair of students who drastically improved support for Escape from Monkey Island (blog, blog), and the work on improving Operation Stealth (blog). Another option is to work on merging (and improving) someone else's reverse engineering work, such as was done with the ZVision engine (blog).

If you'd prefer to improve ScummVM more directly, there are even more options available there; in the past, students have (to give some examples) improved our OpenGL support, added a testing framework (blog), improved our scaler code (blog), written a new GUI framework, added loadable modules for embedded platforms (blog), rearchitected our keyboard input code (blog) and added support for high-colour (16bpp and above) graphics. It's difficult for us to imagine ScummVM as it was before some of these projects, you can make a huge difference!

Tasks

General contacts: Our Discord server our mailing list, or contact sev, Arnaud Boutonné

The ideas here are meant to be just that - ideas. We hope they help inspire your proposals, but you should also consider suggesting your own completely new project ideas. Pick something you really want to see improved/fixed, and come and talk to us about it!

If you're looking for more inspiration for ideas, beware of our TODO (and the other TODO lists linked from there) and our OpenTasks pages. Many of the tasks listed there might be incomplete or outdated, or too difficult for a new developer. The best thing to do is to come and talk to us!

Game Tasks

Technical contacts: Our Discord channel, our mailing list, or contact sev, John Willis, Arnaud Boutonné, Filippos Karapetis,

If you already have reverse engineering experience, you could consider working on one of the external in-development game engines, or even on support for a new game. However, doing this kind of work is very difficult and time-consuming - you would have to convince us that you have the necessary skills to actually be sufficiently productive, probably by demonstrating some actual progress first.

If you don't feel quite up to that level of challenge, we have lots of other suggestions:

Macromedia Director

Technical contacts: sev

Difficulty level: Medium. You'll need a reasonable level of programming experience, and probably some Director games.

Many 90s-era adventure games were developed using the Macromedia (now Adobe) Director tool. It would be nice to be able to play these games in ScummVM! We have a WIP engine in ScummVM tree, but it requires much more work in order to implement all hundreds of Lingo commands.

Enhance SAGA engine for supporting Amiga Inherit the Earth

Technical contacts: sev

Difficulty level: Medium.

We have been supporting the Inherit the Earth game for a long while. However, Amiga versions are not yet supported by this target. We have the original source codes, and the main difference is the data bundles format.

The Immortal

Technical contacts dreammaster or sev

Difficulty level: Hard. Good knowledge of C++ and assembly (x86 or 68K or 6502) is required.

The immortal was released in 1990 by Electronic Arts. It's a mix of genres involving RPG elements with action and puzzles. The gameplay is different one variant to the other, and all variants are written in assembly, making it more difficult to support all the variants.

In 2018, a GSoC student picked this task but, due to personal issues, didn't manage to complete the task. The purpose of the task is therefore to implement an engine for a variant of the game, using the original sources and the work of JoeFish as a documentation.

Screenshots on Mobygames


Bring your own Adventure or RPG Reimplementation

Technical contacts: Talk to us on IRC, or send us an email.

Difficulty: Hard. You'll need good knowledge of C++, as well as knowledge of (reading) assembly.

Our project consists of re-implementations of classic games, and we have listed a number of potential new game engines that you could work on here on our ideas page. However, you may have a classic 2D Adventure game or Role Playing Game (RPG) you are interested in yourself that is suitable for ScummVM that you would like to reverse engineer and re-implement. If so, great!

Adding a completely new game engine is not easy, and you will have to convince us that you are aware of the challenges involved, that the game you are interested in is feasible, and that you have the necessary skills. Preferably, you will already have done some preliminary investigation, into for example data file formats, disassembly, etc.

Please come talk to us to see if we have a mentor who would be interested in working with you on such a game. We'd be happy to help out.

Smaller Tasks

Add Keymapper to more games

Technical contacts: sev

Difficulty: Easy

ScummVM includes a global fully configurable keymapper, but this requires engines to be adapted to use it. The feature documentation: Keymapper, some reference implementations: Wintermute has per-game keymaps; a pull request with adding keymapper to HDB engine; a commit with adding Keymapper to a simpler engine, Griffon.


Support Unicode input in GUI

Technical contacts: sev

Difficulty: Medium

Last year we enhanced our GUI for supporting Unicode output. Now we need to enhance our input system, so Unicode input is supported as well. This includes RTL support (we have FriBiDi employed for output).

Infrastructure Tasks

Finally, there's always plenty of other practical tasks on our wishlist!

Game packaging system

Technical contacts: sev or DJWillis

ScummVM offers 9 freeware games for download, but they need to be downloaded and installed manually. It would be great to develop a universal system which would let us describe a game, e.g. provide screenshots, game descriptions, metadata, and package it for different platforms, so we could put them to different application distribution systems bundled together with ScummVM. For example, we could have Beneath a Steel Sky bundled together with ScummVM, with its own logo, description and instructions on how to add another game along the way.

Potentially and in the future this system could also be used for DLC on platforms which support it, like Steam, Android Play Store or Apple App Store, though support for Android and iOS is out of scope for this project.

Examples are: Linux packages, Google Play, Apple App Store, Steam, ForgeTV store, and anything beyond that.

In-app downloads of demos, freeware games, and addons

Technical contacts: sev

Background

Similar to "Game packaging system", provide a means for users to download demos, freeware games, and game addons (e.g. subtitle packs) from within the ScummVM app.

These downloads are all currently hosted on https://www.scummvm.org/. In order to use them, the user must go to the website, find the listing, download and extract the files, place them in a location of their choosing, open ScummVM, navigate to the downloaded files, and then navigate through any additional dialogs.

Proposal

It would be much better to add functionality to ScummVM allowing for users to

  1. Browse demos and freeware games within the app
  2. Click a button to download and automatically add it to ScummVM (behind the scenes, it downloads to a path such as the "Application Support" folder, just like ScummVM preferences and logs)
  3. Manage and delete existing installations downloaded in this manner

This feature would be able to be able to be enabled or disabled during compilation. It would presumably be enabled on general desktop releases (e.g. Windows, macOS, Linux), but disabled on bundled releases (e.g. version included with GOG.com or Steam games) and releases for limited hardware or no internet connectivity (e.g. handheld console ports).

User benefits would be a better first-time experience (no more opening ScummVM and finding they can't do anything yet), greater discoverability of the sorts of games that ScummVM supports, and greatly simplifying what is now a multi-step process.

Examples

Examples of this sort of in-app download feature in other open-source projects include:

  • The content installer in OpenRA (allows for downloading Command & Conquer games released as freeware by EA)
  • The "homebrew tab" in OpenEmu (allows for downloading "fanmade" homebrew ROMs with no commercial assets, freely released by the authors)

Support for shaders and arbitrary scalers

Technical contacts: sev

Difficulty: Medium

ScummVM uses software scalers for graphics enhancements. In 2012 we were running GSoC for turning them into plugins. That work It was recently merged in ScummVM but could require some more love like adding xBRZ scalers.

Modern systems often have OpenGL with shader support. RetroArch project shaders are standard for them in open source gaming. LordHoto started and rootfather continued work on adding support for those to ScummVM. Their unfinished work could be found here: https://github.com/lotharsm/scummvm/tree/shaderscaler . There is also a second branch that adds a hard-coded CRT shader that may be useful as a reference. This can be found here: https://github.com/braindx/scummvm/tree/crt-emulation

We need to add both improvements to our scaler system. Recent PSP2 port already adds some basics for scalers, particularly in GUI, so that could be reused too.

We need to have it tested on desktops and at least Android, but preferably also Windows and iOS.


System for checking the game files integrity

Technical contacts: sev

Difficulty: Medium

ScummVM requires game data files to operate. Very often, especially when copying from the old media, the files could be damaged. Thus, we need a system that could let the end-users compute all the checksums and compare them with the reference.

The solution will consist of two parts: server and additional functionality within ScummVM. In order to avoid any potential problems with the copyrighted material, only checksums could be passed to the server.

The ScummVM part:

Calculates checksums of all files of a given game/title and submits them to the server. After receiving the response from the server, the end-user is presented with the results of the check: if all files are correct or list of files with different checksums.

Optionally, the users could have the possibility to give their consent to submit their checksums as the new game variant.

The server part:

It should keep checksums of all files of all known games in a DB.

It can receive a list of files to check against from ScummVM, perform a match with the DB and provide the result back in machine-readable form.

Additionally, it must support command-line utility for mass-populating the DB, performed by the developers.

Additionally, it must have a web interface that will let the authenticated users (developers) browse through the existing checksums.

Optionally, it could have a way to see and approve the submitted entries.