{"id":17231958,"url":"https://github.com/pushfoo/pyc2e","last_synced_at":"2025-04-14T01:50:49.434Z","repository":{"id":62579121,"uuid":"262562731","full_name":"pushfoo/pyc2e","owner":"pushfoo","description":"A pure python interface for managing c2e instances and injecting CAOS","archived":false,"fork":false,"pushed_at":"2024-03-19T03:38:37.000Z","size":75,"stargazers_count":2,"open_issues_count":8,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-27T15:52:45.331Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pushfoo.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-05-09T12:08:52.000Z","updated_at":"2023-02-18T12:35:22.000Z","dependencies_parsed_at":"2022-11-03T21:00:54.408Z","dependency_job_id":null,"html_url":"https://github.com/pushfoo/pyc2e","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pushfoo%2Fpyc2e","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pushfoo%2Fpyc2e/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pushfoo%2Fpyc2e/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pushfoo%2Fpyc2e/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pushfoo","download_url":"https://codeload.github.com/pushfoo/pyc2e/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248809024,"owners_count":21164895,"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-15T05:00:09.975Z","updated_at":"2025-04-14T01:50:49.416Z","avatar_url":"https://github.com/pushfoo.png","language":"Python","readme":"=====\npyc2e\n=====\n\n.. |PyTest results| image:: https://github.com/pushfoo/pyc2e/actions/workflows/test.yaml/badge.svg\n   :target: https://github.com/pushfoo/Fontknife/actions/workflows/test.yaml\n\n.. |GitHub license| image:: https://img.shields.io/github/license/pushfoo/pyc2e.svg?color=brightgreen\n   :target: https://github.com/pushfoo/pyc2e/blob/master/LICENSE\n\n.. |PRs Welcome| image:: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square\n   :target: https://makeapullrequest.com\n\n|PyTest results| |GitHub license| |PRs Welcome|\n\n\nA pure Python interface for injecting `CAOS code \u003chttps://creatures.wiki/CAOS\u003e`_ \u0026 reading output from the\n`Creatures Evolution Engine (c2e) \u003chttps://creatures.wiki/Creatures_Evolution_Engine\u003e`_.\n\n\nIt works by calling relevant parts of the Win32 API through `Python's built-in ctypes module \u003chttps://docs.python.org/3/library/ctypes.html\u003e`_, as described in `Chris Double's documentation\nof the c2e shared memory interface \u003chttp://double.nz/creatures/developer/sharedmemory.htm\u003e`_.\n\n\n----------\nInstalling\n----------\n\nThe only requirements are:\n\n* Python 3.7+\n* A compatible c2e version running in the same permission space as the Python interpreter\n\n.. list-table::\n   :header-rows: 1\n\n   * - Install Method\n     - Benefits\n     - Steps\n\n   * - With `pip`\n     - Easiest\n     - #. `Create \u0026 activate a virtual environment \u003chttps://docs.python.org/3/library/venv.html\u003e`_\n       #. ``pip install pyc2e``\n\n   * - From source\n     - Freshest code\n     - #. `Clone this repository \u003chttps://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository#cloning-a-repository\u003e`_\n       #. ``cd pyc2e``\n       #. `Create \u0026 activate a virtual environment \u003chttps://docs.python.org/3/library/venv.html\u003e`_\n       #. ``pip install -e .``\n\n\n-------------------\nUsage \u0026 Limitations\n-------------------\n\n*Warning: Running custom CAOS can break your Creatures 3 / DS install.*\n\nRunning \u0026 injecting `CAOS \u003chttps://creatures.wiki/CAOS\u003e`_ on Windows is reasonably complete.\n\n.. list-table::\n   :header-rows: 1\n\n   * - CAOS Origin\n     - Command Syntax\n\n   * - From files\n     - ``pyc2e inject --file filename.cos``\n\n   * - Piping from standard input\n     - ``cat filename.cos | pyc2e inject``\n\n   * - Strings passed as arguments*\n     - ``pyc2e inject --caos \"outs \\\"testing\\\"\"``\n\n*\\*On Windows, you might need to omit the escapes around the quotes.*\n\n----------------------\nUnimplemented Features\n----------------------\n\nEngine, config, and launch management for testing and/or fuzzing may be added later.\n\nSupport for the Linux version will likely stay incomplete because the community prefers the Windows version for multiple reasons:\n\n#. The Linux version is difficult to install:\n\n   #. Dwindling support for 32 bit code on maintained amd64 Linux distros\n   #. Bit rot is rendering precompiled dependencies unusable\n   #. Difficulty finding package downloads of linux packages built in 2000\n\n#. All Windows versions crash much less than the Linux builds\n#. Running WINE or a VM does not have prohibitive performance penalty for a game this old\n#. There are Windows versions of Docking Station and C3 available from multiple sources:\n\n   .. list-table::\n      :header-rows: 1\n\n      * - Source Link\n        - Price\n        - Creatures 3 Included\n        - Win10 Compatibility Patches\n\n      * - `Eemfoo archive \u003chttps://eem.foo/archive/search?query=docking+station\u0026game=\u0026tags%5B%5D=%21program_patch\u003e`_\n        - Free\n        - No\n        - No\n\n      * - `Steam (Creatures: The Albian Years) \u003chttps://store.steampowered.com/app/1818340/Creatures_The_Albian_Years\u003e`_\n        - $5.99 USD\n        - Yes\n        - Yes\n\n      * - `GOG (Creatures: The Albian Years) \u003chttps://www.gog.com/en/game/creatures_the_albian_years\u003e`_\n        - $5.99 USD\n        - Yes\n        - Yes\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpushfoo%2Fpyc2e","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpushfoo%2Fpyc2e","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpushfoo%2Fpyc2e/lists"}