Repository navigation
Releases
Animal Crossing: City Folk Recompiled 1.0.4
Discord: news, help and bug reports for all my projects: https://discord.gg/cM4chZtgh7
Animal Crossing: City Folk Recompiled 1.0.4 adds Quick Start: open the game and be walking out of your house a few seconds later. Installed copies are offered it by the built-in updater (F1 > Game > Updates); settings and saves are not touched.
Downloads
| File | Platform | SHA256 |
|---|---|---|
CityFolkRecompiled-1.0.4-windows-x64.zip |
Windows 10/11, 64-bit, Direct3D 12 | d3d4534e55e5af4c0eb6647dd0c0980f86b63a689fc8d1a677995b4fe15197de |
CityFolkRecompiled-1.0.4-linux-x86_64.tar.gz |
Linux x86_64, glibc 2.34+, Vulkan | 0bff07c75a83192662cb10fc11296e5bd83c3bb36008be4e819708cb3fd3139c |
CityFolkRecompiled-1.0.4-macos-arm64.tar.gz |
macOS 13+, Apple silicon (M1 or newer), Metal; unsigned | 1e178029441934a662b75a20c0376bf5da975626998f8ec267ca01305781e9dd |
macOS: the package is built by GitHub Actions and is not signed or notarized by Apple. Before the first start run xattr -dr com.apple.quarantine on the unpacked folder, or right-click CityFolkRecomp > Open (see README.txt). The macOS version is untested by the developers.
New: Quick Start
F1 > Enhancements > General > Start-up > Quick Start (off by default). With it on, the next launch goes straight into town: the screen stays black for a few seconds and the first thing you see is your resident stepping out of the house. Pick who you play as under Play as if your town has more than one resident.
- Your save is handled exactly as in a normal start. The game's own start-up still runs (title, Rover, resident select, "Preparing saved data"), just hidden and as fast as your PC allows, so every save check and write happens as usual. Mr. Resetti, letters, events and the new day all still happen in town.
- About 5 seconds from opening the game to walking out of the house, instead of about a minute (with the shaders already prepared; the first launch after an update takes longer).
- Normal start for one launch: hold Shift (or B) while the game starts.
- It steps aside by itself when there is no save yet, the save can't be read, the chosen resident has moved out, or Rover says something unusual; you then get the normal screens. F1 shows what the last launch did and why.
Animal Crossing: City Folk Recompiled 1.0.3
Discord: news, help and bug reports for all my projects: https://discord.gg/cM4chZtgh7
Animal Crossing: City Folk Recompiled 1.0.3 fixes more water reflections and two menu problems at high frame rates. Installed copies are offered it by the built-in updater (F1 > Game > Updates); settings and saves are not touched.
Downloads
| File | Platform | SHA256 |
|---|---|---|
CityFolkRecompiled-1.0.3-windows-x64.zip |
Windows 10/11, 64-bit, Direct3D 12 | 406a1a83e7d07e8a311fc3f1e16e6c7371ed9fce7d15b48a3a55df7d5eadf725 |
CityFolkRecompiled-1.0.3-linux-x86_64.tar.gz |
Linux x86_64, glibc 2.34+, Vulkan | a7b20496f0769f9e6ef81a039a63416a1be73e04cb34b70cff593e53ac693227 |
CityFolkRecompiled-1.0.3-macos-arm64.tar.gz |
macOS 13+, Apple silicon (M1 or newer), Metal; unsigned | 2d6d2f4f7e35189511c69cbdd7721dbcd1ba4a931dbe92b510b295d51f90b300 |
macOS: the package is built by GitHub Actions and is not signed or notarized by Apple. Before the first start run xattr -dr com.apple.quarantine on the unpacked folder, or right-click CityFolkRecomp > Open (see README.txt). The macOS version is untested by the developers.
Fixes
- Hats reflect on your head. With a hat on, the reflection in the water showed loose pieces of it floating past the head (the wizard's cap as scattered stars). Hats, glasses, masks, umbrellas, tools and anything held up are now mirrored together with the character, villagers' umbrellas in the rain included.
- The fishing rod reflects once. Fishing, the rod showed up in the water as a broken stack of several pieces. It is now one rod in the reflection; the bobber is unchanged.
- Menus no longer jump at high frame rates. Above 30 fps the scrolling pattern behind menu windows jumped back every so often. It now scrolls smoothly.
- The pointer goes to OK on pop-ups. When a message such as "You can't place an item here" opens over a menu, the pointer now snaps to its OK button instead of the menu items underneath.
Nothing changes with water reflections off. The reflection fix costs no measurable GPU time.
Animal Crossing: City Folk Recompiled 1.0.2
Discord: news, help and bug reports for all my projects: https://discord.gg/cM4chZtgh7
Animal Crossing: City Folk Recompiled 1.0.2 fixes the water reflections from 1.0.1. Installed copies are offered it by the built-in updater (F1 > Game > Updates); settings and saves are not touched.
Downloads
| File | Platform | SHA256 |
|---|---|---|
CityFolkRecompiled-1.0.2-windows-x64.zip |
Windows 10/11, 64-bit, Direct3D 12 | 6b2aebbe5fa12f9172b62f336d61b0afe857f1ad695e46a865159d6610ded11b |
CityFolkRecompiled-1.0.2-linux-x86_64.tar.gz |
Linux x86_64, glibc 2.34+, Vulkan | 8f170e15732a78d7f640b494f999e63a2daf97116e860d903fbb51d0880b104e |
CityFolkRecompiled-1.0.2-macos-arm64.tar.gz |
macOS 13+, Apple silicon (M1 or newer), Metal; unsigned | 7ea7fae127ba6e83f75be8c02ed5c722bf9ffa64cc7e22806e6c6dd3af71fcc5 |
macOS: the package is built by GitHub Actions and is not signed or notarized by Apple. Before the first start run xattr -dr com.apple.quarantine on the unpacked folder, or right-click CityFolkRecomp > Open (see README.txt). The macOS version is untested by the developers.
Fixes (Enhanced world > Water reflections)
- Your head no longer goes missing from the reflection. Standing a few steps back from a cliff edge or a bank above a pond, the reflection showed the body without the head. The head and body now always reflect together, and a cliff in front of the water hides the reflection's feet first, as it should.
- The Mii mask's face reflects. The reflection showed the Mii head with a blank face; the eyes, eyebrows, mouth and glasses now show too, also when seen from a cliff top.
- Bridges reflect as whole bridges. The mirrored bridge used to be a ragged fragment pieced together from what the camera sees. The bridge is now drawn mirrored under the river, with the full arch and a clean outline, and hides the reflection of a player standing on it.
- Fainter over the shallows. On the beach the reflection started at full strength on the sand-coloured surf. It is now faint over shallow water and grows stronger toward the deep blue water, with no visible line. Reflections over ponds and rivers are more visible than in 1.0.1.
- Cleaner edges: the reflections of cliffs and banks along the waterline end in a soft edge instead of ragged pieces.
Water reflections cost about 0.3 ms more per frame at 4K than in 1.0.1. Nothing changes with water reflections off.
Animal Crossing: City Folk Recompiled 1.0.1
Animal Crossing: City Folk Recompiled 1.0.1 is a hotfix for two graphics bugs found while recording the trailer. Installed copies are offered it by the built-in updater (F1 > Game > Updates); settings and saves are not touched.
Downloads
| File | Platform | SHA256 |
|---|---|---|
CityFolkRecompiled-1.0.1-windows-x64.zip |
Windows 10/11, 64-bit, Direct3D 12 | 9120351de495d6c4437d55f337d22b06914a15d63a284f43d736790d81127b8d |
CityFolkRecompiled-1.0.1-linux-x86_64.tar.gz |
Linux x86_64, glibc 2.34+, Vulkan | 230a088dc28c8c9eeefbeccec6b63daf7aaa1da4cc8466dabbc0671a90bbb008 |
CityFolkRecompiled-1.0.1-macos-arm64.tar.gz |
macOS 13+, Apple silicon (M1 or newer), Metal; unsigned | ea74d98812e424f2f1b48d4be98bc3a97f29fb11ee93bb0cea3d2aea8c54979a |
macOS: the package is built by GitHub Actions and is not signed or notarized by Apple. Before the first start run xattr -dr com.apple.quarantine on the unpacked folder, or right-click CityFolkRecomp > Open (see README.txt). The macOS version is untested by the developers.
Fixes
- Characters' reflections in the water (Enhanced world > Water reflections): your character, villagers and other characters now reflect as whole figures seen from below. Before, the reflection was pieced together from what the camera sees, so the face floated away from the head, a patch of hair sat below it, and the body almost vanished in shallow water near the shore. This works with the Mii mask on or off, on every region's disc. Characters are drawn a second time, mirrored under the water; the rest of the world reflects as before. The cost is about 0.6 ms per frame at 4K, and nothing changes with water reflections off.
- Black corners in the sky on ultrawide screens: at 21:9 and wider, the town's sky had black rectangles in the top corners above the horizon. The sky and clouds now reach the edges of any aspect ratio. 16:9 is unchanged. (At night the stars still only appear in the middle 16:9 part of the sky.)
Other
- The README, the package READMEs and every release page now link to the Discord for news, help and bug reports: https://discord.gg/cM4chZtgh7
Animal Crossing: City Folk Recompiled 1.0.0
Discord: news, help and bug reports for all my projects: https://discord.gg/cM4chZtgh7
Animal Crossing: City Folk Recompiled 1.0.0 is the first public release of a native PC port of Animal Crossing: City Folk (Wii; Let's Go to the City in Europe and Australia, Machi e Ikou yo: Doubutsu no Mori in Japan). The game's code is translated from its PowerPC machine code into C++ and compiled for your computer, so it runs natively on Windows, Linux and macOS with no emulator. It is built like our Luigi's Mansion port, on the Aurora engine (WebGPU/Dawn + SDL3).
No game data is included. On first start the game asks for your own City Folk disc: a Wii disc image (ISO, WBFS, RVZ, WIA, CISO, GCZ) or a Dolphin "Extract Entire Disc" folder. Supported: revision 1 of the USA (RUUE01), European (RUUP01), Japanese (RUUJ01) and Korean (RUUK01) releases. Setup identifies the disc by its game code, refuses revision 0 and modified game code, and warns when other game files differ from the retail disc (a damaged or modified dump). One disc of any region is a complete install, since every disc already carries every region's events and items. Setup then builds the game for your PC with the bundled compiler, which takes about a minute. Read the README.txt in the package for details.
Downloads
| File | Platform | SHA256 |
|---|---|---|
CityFolkRecompiled-1.0.0-windows-x64.zip |
Windows 10/11, 64-bit, Direct3D 12 | 7e3f33074f8a3e9629752d00a13ea824c92eedf6cf719cef06d98df3c6d8c913 |
CityFolkRecompiled-1.0.0-linux-x86_64.tar.gz |
Linux x86_64, glibc 2.34+, Vulkan | e0bfae986c118fa7bbe6ec78f2f0bc2b4d8d84b252c2b50b9e883a3976da5d64 |
CityFolkRecompiled-1.0.0-macos-arm64.tar.gz |
macOS 13+, Apple silicon (M1 or newer), Metal; unsigned | 8a5f3b58ca8dd5c0bec085a2df7515ccc1cdc3b77aca668af227d417043dd8c7 |
macOS: the package is built by GitHub Actions and is not signed or notarized by Apple. Before the first start run xattr -dr com.apple.quarantine on the unpacked folder, or right-click CityFolkRecomp > Open (see README.txt). The macOS version is untested by the developers.
Features
Every option is in the F1 menu (Esc closes it). Everything that changes the game is off by default, so the game plays as it did on the Wii until you turn it on.
Graphics
- Any resolution, widescreen and ultrawide. The game's own 16:9 mode at any window size, wider screens in Hor+, and a render-resolution slider. The HUD can stay at 16:9 or spread to the screen's edges. Multisample anti-aliasing is also available.
- High frame rates. The game logic runs at its original rate (60 updates per second, 50 for 50 Hz European games), and the frames in between are interpolated, up to 320 fps. "Match display refresh rate" and VRR/G-SYNC aware pacing are included, and "Original" keeps the console's frame rate.
- Accurate Wii rendering, checked against Dolphin place by place: EFB copies (including to RAM, so photos and in-game captures work), depth textures, fog, TEV/indirect effects and copy filters. A shader precache prepares the pipelines before the game starts.
- Enhanced lighting (optional; Low / Medium / High / Ultra presets): sun and moon shadows from the game clock, soft shadows, up to 256 coloured point lights (lit windows, lamps in the city, fireflies, fireworks), furniture lights in houses and shops (lamps, TVs, fireplaces, candles), ambient occlusion, bloom, time-of-day grading and sun shafts. Its shaders are prepared in the background from launch, so switching it on later (also during an online visit) does not stop the game.
- Enhanced world (optional): water reflections, wet ground and puddles in the rain, snow sparkle, haze on grey days, and seasonal particles (cherry petals, autumn leaves, snowflakes).
- CRT filter with RGB, S-Video, composite and RF signal looks.
- Texture packs in Dolphin's format, with a texture dumper for pack makers.
Controls
- Wii pointer from the mouse, a stick or gyro, and a default gamepad layout for Xbox, PlayStation, Switch and other controllers (based on the Wii Classic Controller layout). Bindings, dead zones, sensitivity and rumble can all be changed per port.
- Menus with a normal controller: "Snap pointer to menu items" moves the pointer from item to item with the D-pad or stick, and puts it on the highlighted choice when a choice box appears. The pointer jumps to the choice wherever it was on screen (unless you are moving the mouse), and two-panel screens such as the recycle bin and letters let the D-pad move between the panel and your pockets.
- Real Wii Remotes over Bluetooth or a Mayflash DolphinBar (mode 4): buttons, IR pointer (needs a sensor bar), Nunchuk, rumble and the Remote speaker.
- Type with your PC keyboard wherever the game takes a USB keyboard (letters, chat, names, designs).
- DSU (cemuhook) motion controllers.
Online
- Visit other players' towns again (F1 > Online). The lobby lists open rooms, so you can join with one click, with an optional password, Friends only rooms, 2 to 4 players, and LAN rooms in the same list. Connections are encrypted and direct between players, with hole punching and a relay when two routers cannot reach each other. The lobby only introduces players to each other and never sees game data.
- Wii Speak voice chat from your PC microphone (off by default; no recording device is opened until you turn it on) and keyboard chat during visits.
- Letters between towns during visits, and optionally through your own email account ("Always online mail", Windows only).
- Nintendo events (off by default): the letters with items and the designs Nintendo sent City Folk players over WiiConnect24 from 2008 to 2012, delivered through the game's own WiiConnect24 code (Pete brings the letters). You can get them in turn, on their original dates, or when you choose. "Receive now" gives each event once per town. The archive is downloaded at run time from WiiLink and is never part of the package.
Gameplay options
- Content from other regions: every region's events and holidays in your town, plus choices for the Autumn Moon, Mother's and Father's Day dates, the title screen logo and villager house styles. All of it is on your disc already.
- Hemisphere: Northern (original) or Southern, with the seasons shifted by six months.
- Real-time weather (off by default): pick your town or city by name, and the game's weather follows the real weather there (from Open-Meteo; only the place's rounded coordinates are sent).
- Grass wear: Original, New Leaf style or Off.
- Skin tone for the resident you are playing.
- Unused items at Nook's (Unused content tab): 19 items that are in the game but were never sold, offered one at a time.
Your saves and Miis
- Import a save from Dolphin, a Wii NAND backup or the SD card's data.bin (with your own console's SD key), and export the port's save back to Dolphin (F1 > Game > Save data). Every import is checked with the game's own checksums and the old save is backed up first.
- Mii maker (F1 > Miis): there is no Mii Channel, so the port has its own Mii maker with every Wii Mii option, for Harriet's Mii mask makeover at Shampoodle. Miis can also be imported and exported.
- Move in from Wild World: Rover's "Move from the DS!" works with a Wild World save file in place of a DS.
- Photos to a folder: in the game's Photos window, SD Card > Save Photo writes the photo (the game's own 896x480 JPEG,
RUU_0001.JPG, ...) into ascreenshotsfolder next to the game. Erase All never deletes these files. F1 > Game > SD Card has the switch and "Open screenshots folder".
The program
- First-run setup for your own disc. Several regions can be installed side by side; pick which one to play in F1 > Game.
- Automatic updates: the game checks GitHub for new releases at startup, in the background (F1 > Game > Updates; it can be turned off). Downloads are checked against their SHA-256 before anything is replaced, and settings and saves are never touched.
- Portable mode: put a file named
portable.txtnext to the program to keep everything in aportablefolder next to it.
System requirements
- Windows: Windows 10 or 11, 64-bit, a graphics card with Direct3D 12.
- Linux: x86-64, glibc 2.34 or newer (Ubuntu 22.04+, Debian 12+, Fedora 36+, SteamOS 3.5+), a Vulkan driver, X11 or Wayland.
- macOS: macOS 13 or newer on Apple silicon (M1 or newer).
- About 2 GB of free disk space for the game module and shader caches.
- Enhanced lighting at Ultra, 4K and high frame rates need a strong graphics card. The default settings run on modest hardware.
Installing
- Unpack the package anywhere (on Windows, not inside Program Files).
- Start
CityFolkRecomp.exe(Linux:CityFolkRecompiled.sh, macOS:CityFolkRecomp). - On the setup screen, pick your disc and click "Install". The game code is translated and compiled for your PC (about a minute), then the shaders are prepared.
Settings and saves live in %APPDATA%\Animal Crossing City Folk Recompiled (Linux: ~/.config, ~/.local/share and ~/.cache; macOS: ~/Library/Application Support). When reporting a problem, attach last_run.log from that folder.
Known issues
- macOS is built by GitHub Actions and has not been run by the developers. It is not signed or notarized (see the note above).
- Online play has been tested between two PCs on one network and through the relay. Visits between homes behind every kind of router have had little testing so far. On Linux and macOS, "Always online mail" is not available yet.
- The first time a new kind of effect or place appears, a short stutter can occur while its shaders compile. The shader cache keeps them for later sessions.
- At some interpolated frames, a faint dotted seam can show on characters' faces.
- Enhanced lighting and Enhanced world are new; their look may still change in updates...