{"id":16852627,"url":"https://github.com/deckarep/sci-rave-hires-portrait-encoder","last_synced_at":"2025-03-18T10:16:54.231Z","repository":{"id":194155804,"uuid":"690224072","full_name":"deckarep/SCI-Rave-Hires-Portrait-Encoder","owner":"deckarep","description":"A utility to encode RAVE Hires Character Portraits for the Sierra game King's Quest 6","archived":false,"fork":false,"pushed_at":"2023-09-11T19:48:51.000Z","size":89,"stargazers_count":2,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-24T16:34:02.382Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/deckarep.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-11T19:22:06.000Z","updated_at":"2023-10-01T21:44:03.000Z","dependencies_parsed_at":null,"dependency_job_id":"19c46258-959d-41bb-9a89-f7952dad2183","html_url":"https://github.com/deckarep/SCI-Rave-Hires-Portrait-Encoder","commit_stats":null,"previous_names":["deckarep/sci-rave-hires-portrait-encoder"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deckarep%2FSCI-Rave-Hires-Portrait-Encoder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deckarep%2FSCI-Rave-Hires-Portrait-Encoder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deckarep%2FSCI-Rave-Hires-Portrait-Encoder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deckarep%2FSCI-Rave-Hires-Portrait-Encoder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deckarep","download_url":"https://codeload.github.com/deckarep/SCI-Rave-Hires-Portrait-Encoder/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244198395,"owners_count":20414443,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-13T13:48:06.791Z","updated_at":"2025-03-18T10:16:54.207Z","avatar_url":"https://github.com/deckarep.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sierra RIVE Encoder\n\nFor fellow Sierra and fans of the original King's Quest Adventure games this utility is the first of its kind (to my \nknowledge) that allows a person to edit/modify/create brand new RIVE encoded hires talking/animated\nportraits for the game King's Quest 6.\n\n## Demo Time!\n\nhttps://github.com/deckarep/SCI-Rave-Hires-Portrait-Encoder/assets/200686/e6e95679-27f4-41f9-8ed1-12df32562d0f\n\nThings you can currently do:\n\n- Modify existing character portraits\n- Modify existing character color palettes\n- Create entirely new characters (based off existing characters)\n\nThings you can't yet do:\n\n- Modify lip-sync data\n- Create new mouth/facial movements\n- Go beyond 256 colors - a limitation of the original game not this utility.\n\n## How it works\n\nA new character `.json` definition file must be created and you must additionally include the original game BIN\nfile assets in a directory named `Originals`. These files are needed because the lip-sync data is pulled from\nthese files which will be fully compatible with your new character and the game.\n\nA reference character has been built in the folder: `Characters/KingGraham` that matches the original dimensions\nand voice movements. If an original game character had `16` images, your new character must have `16` matching images\nbut the placement and sizing of these images can vary so long as they fit within the primary portrait dimensions of\n`112 Width x 154 Height`. This is currently mandatory because the game expects portraits in this size however the size\nand placement of the overlay images can be different from the original.\n\nTherefore to create an entirely new character you need to:\n\n- Create a new directory in `Characters/\u003cchar-name\u003e/`\n- Create a new .json definition file\n- Create a fresh set of `.png` images of the correct dimensions\n- Run the command\n\n## Running the command\n\nCurrently the tool requires the Go SDK. If there is interest/demand, i'll provide a downloadable tool that requires no \ndeveloper tools to be installed.\n\nSimply point the utility to the appropriate `JSON` file in the appropriate directory and be sure that you have placed the \nsame original `BIN` files in the `Originals/` folder. This requires that you have your own copy of Hires version of \nKing's Quest 6 where the original files can be found in a folder called: `ACTORS/`. Without these original `.BIN` files\nthis script will error out.\n\nOnce everything is setup you can run the command like so:\n\n```go\ngo run main.go Characters/KingGraham/GRAHAM.json\n```\nIf the command runs with no errors you should see a file generated in the character folder called:\n`\u003ccharacter-name_GEN.BIN\u003e`. Which can be placed in your version of the KQ6 `ACTORS/` folder. Be sure to overwrite the existing\ncharacter or the new file will not be used by the game.\n\n## Credits\n\nThis utility was only possible by referencing the RAVE file-format documented in the SCUMMVM implementation. Many thanks\ngoes to the original contributors to SCUMMVM and the FreeSCI project who took to the time to reverse engineer Sierra's\ngreat gaming legacy.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeckarep%2Fsci-rave-hires-portrait-encoder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeckarep%2Fsci-rave-hires-portrait-encoder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeckarep%2Fsci-rave-hires-portrait-encoder/lists"}