Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 9 additions & 3 deletions wifecraft/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ An Android scene simulation. Choose a location, pick or create NPCs, and select
1. Open **Choose Scene** and pick the Stormwind Embassy.
2. Select up to six NPCs. **Create NPC** saves a character to your roster. NPCs from older projects also appear in the roster.
3. Enable interactions for objects already in the scene. Stormwind Embassy uses its existing study table and books.
4. Begin the scene. NPCs wander until you give them an order (with **Partner** on, two may also start a partner animation together: Sims 4 animations, below). Select an NPC in the room or in the cast bar, then tap an object or choose an interaction. **NPC camera** follows the selected NPC. Drag to orbit and pinch or use the zoom buttons. Tap the floor in **NPC camera** to send the selected NPC there. **Room camera** restores the room view. **End scene** returns to the title.
4. Begin the scene. NPCs wander until you give them an order (with **Partner** on, two may also start a partner animation together: Sims 4 animations, below). The scene fills the screen with its HUD over it, in the menus' look: a top bar (the place, the clock, and the gear for the scene menu: Resume, Options where offered, **End scene**), the cast as party frames (down the left on a wide screen, a strip under the top bar on the cover screen standing; the NPC you control lit gold, their partner in rose), a line of help, and an action bar. Tap an NPC (in the room or their frame) to control them; tap another NPC to make them the partner (the **Partner: name ×** chip clears it); tap the frame again, **Release** or empty floor to let go. The action bar shows six orders at a time (two rows of three on the cover screen standing), with a page button at its end for the rest: **Walk** (the camera follows the NPC; tap the floor to send them there, drag to orbit, pinch or use the zoom buttons), **Play animation**, **Partner animation** (with a partner), **Say…**, **Chat with…**, **Stop repeat** and **Clear queue** while there is one, **Release**, then the scene's objects (**Sit in chair**, **Read a book**...) and **Free will**. Tapping an object in the room still uses it.

The Stormwind Embassy uses the existing wago.tools location pack. The title and scene setup use the original Wifecraft menu backdrop. The title emblem and first-launch download art also come from the earlier Wifecraft builds. Warcraft controls and selector icons load from wago.tools. The character, furniture, and book models load through the app's existing wago.tools pipeline.

Expand All @@ -21,17 +21,23 @@ For WickedWhims, open **Choose objects → Animation library → Import WickedWh

From **Choose objects**, open **Animation library** and select **Import rig and clips**. Choose a Sims 4 animation package or its ZIP or 7z archive. The importer can use a humanoid skeleton included in the package. For packs without one, choose an adult Sims 4 skeleton from your game installation. The importer reports which clips it can retarget and lets you review them before saving.

Use **Animation library → Browse animations** to preview imported clips before a scene. Once the scene starts, NPCs wander. Select an NPC, choose **Play animation**, and pick a solo clip or a partner animation. For a partner animation, pick another NPC and the app starts the two roles together after they meet. **Repeat** loops the selected animation until you stop it or queue another clip. **Queue** adds a clip after the current order, and **Queue stages** follows the stages linked by the author. Reinstall WickedWhims to refresh the grouping, stage links, and authored cycle counts for clips already in your library.
Use **Animation library → Browse animations** to preview imported clips before a scene. Once the scene starts, NPCs wander. Select an NPC and choose **Play animation**: a window with category tabs (All, each group, and **Partner**, first while the NPC has a partner), a search and large rows. Pick a row, then **Preview** plays it once at once with the window kept open, and the main button plays, queues or repeats it as the mode row says (**Play now**, **Queue**, **Repeat**, **Queue stages**). For a partner animation, pick another NPC and the app starts the two roles together after they meet. **Repeat** loops the selected animation until you stop it or queue another clip. **Queue** adds a clip after the current order, and **Queue stages** follows the stages linked by the author. Reinstall WickedWhims to refresh the grouping, stage links, and authored cycle counts for clips already in your library.

The imported Sims rig supplies the source bone hierarchy, bind transforms, and animation curves. The retargeter converts mapped tracks to Warcraft's coordinates and bind pose so Warcraft mesh skinning stays intact. Source clip timing is retained. Ordinary wandering and furniture commands use Warcraft animations.

**Partner animations in the library.** Two kinds of two-person animation are offered, one list for both: an author's performances (WickedWhims and similar packs: the roles, offsets, stages and cycle counts from the pack's own tuning, kept on its clips) and partner animations the importer pairs itself (category **Partner**, saved as one entry with both actors' clips). The importer pairs a package's clips that no author's performance already covers (packages of up to 64 clips; larger ones are converted one clip at a time), in this order: from the package's animation tuning (an entry that lists `animation_actors_list` with each actor's clip name, offset and angle), from the clip names (the same name ending `_x`/`_y`, `_a`/`_b`, `_0`/`_1`, `actor0`/`actor1`, `_xx`/`_yy` or `_male`/`_female`), or from two clips with different actor names, the same length and roots that start apart. Such a pair keeps where each actor stands and faces from the pair's shared origin (one horizontal scale for both, so they stay where the clips put them), whether it loops, the furniture it was made for, and the sound names its clips' events give, with their times. Clips that look like half of a pair are listed on the review under **Clips without a partner**: tap one for actor A and one for actor B, then **Pair these two**. **Animation library → Manage library** has a **Partner** tab to rename, recategorize, turn off for scenes or delete them. Limits: only two-actor animations (three or more are reported); clips whose lengths differ by more than a frame are not paired; prop and object clips, hand IK targets and face curves are not converted; sounds are names only (the audio is not in these packages). Real two-actor packages have not been tested: the pairing follows the format's tools and documentation and synthetic test files.

**Partner animations in the scene.** Every two-person animation plays the same way, whether you chose it with **Play animation**, sent an NPC with **Send to partner**, or two NPCs began one by themselves: both walk to their places around a shared spot, the one waiting turns to face the one coming, and both clips start on the same simulation step and play on one clock, cycle after cycle; the animation's sound events play at their times (Partner sounds, below). By themselves: an idle NPC (not on furniture, not carrying out your order) whose cooldown has passed may go to another idle NPC within six yards (the nearest; a random one of equally near) and play a partner animation picked at random from the enabled ones whose place the scene has (the floor, or the couch, bed or chair it was made for); with none that fits, both play one Warcraft emote their models share (wave, cheer, dance, laugh, bow, kiss, applaud or salute) facing each other. A looping one repeats 1 to 4 times or for 6 to 25 seconds; then both step apart and wait 20 to 60 seconds before doing it again. In **Choose objects**, **Partner** sets how often: Off, Sometimes (the default) or Often, and the row under it counts the partner animations available. **Send to partner** (select an NPC, press it, tap another NPC) sends the selected NPC to start one with that NPC. The cast bar shows "With <name>" for both, and the line under the orders names the animation. Your orders to either NPC and **End scene** interrupt it; the other NPC goes back to idle at once. The simulation is unit-tested on the desktop with fake animations (`simulation/PartnerActivityTest`, `PerformanceTest`); the screens are compiled by CI only, and none of it has run on a phone.

## Music, sounds and the menus

The title, Gathering the Files, the scene's setup, the live scene's HUD (top bar, party frames, action bar, speech bubbles, the Play animation window and its lists), the animation library's page, Options and Updates use the current game's look: dark slate panels with a thin gold trim, rounded buttons that glow when pressed (or hovered with a mouse or stylus), a backdrop that breathes slowly with motes rising over it (still when the phone's animations are off). The character creator keeps its own look.

The menus play the title music of The War Within (MUS_110_MAIN_TITLE); a live scene plays its place's own music and ambience from the game's tables (the Stormwind Embassy: its room's ZoneMusic 1929, six tracks one after another with a short gap, and SoundAmbience 569's day or night loop), crossfading between them. The music dips while an emote's voice or a partner sound plays. Buttons, tabs, switches and windows play the game's interface sounds (SoundKitConstants: IG_MAINMENU_OPEN/CLOSE/OPTION, GS_TITLE_OPTION_OK, IG_CHARACTER_INFO_TAB...). Options > Sound has Enable Sound, Master, Music, Ambience, Sound effects and Dialog, as the game's Sound page; everything is silent while Wifecraft is in the background. The files are the game's, by id (`assets/sounds.json`, made by `tools/sounds.py`), fetched from wago.tools as they are first played once the files have been gathered; a file that can't be fetched leaves silence and is tried again later. The decisions (mixer, ducking, crossfade, which music where, the sound ids) are unit-tested (`audio/Soundscape.kt`); the playback is compiled by CI only and nobody has listened to it on a phone.

## Partner sounds

Options > Game > Partner sounds plays sounds with partner animations from the user's own files. A clip's sound event carries a sound name; put audio files (ogg, wav, mp3, m4a, aac, flac), single or in a zip, through Add sounds, named after those names (the exact name, the name without a `vo_` or `sfx_` prefix, numbered variants `name_01`, `name_02` of which one is picked at random, a file named by the name's 32- or 64-bit FNV-1a hash in hex, or a file called `default` for the rest). A sound with no file is simply silent. The files are kept in `files/partner-sounds`; there is an On box, a volume and Remove all. The game's own EA audio (SNR/SNS) is not decoded yet. The folder (`audio/PartnerSounds`, `SoundNames`) is unit-tested; the playback (`SceneAudio.partnerSound`) and the Options rows are compiled by CI only and have not run on a phone.
Options > Sound > Partner sounds plays sounds with partner animations from the user's own files. A clip's sound event carries a sound name; put audio files (ogg, wav, mp3, m4a, aac, flac), single or in a zip, through Add sounds, named after those names (the exact name, the name without a `vo_` or `sfx_` prefix, numbered variants `name_01`, `name_02` of which one is picked at random, a file named by the name's 32- or 64-bit FNV-1a hash in hex, or a file called `default` for the rest). A sound with no file is simply silent. The files are kept in `files/partner-sounds`; there is an On box, a volume and Remove all. The game's own EA audio (SNR/SNS) is not decoded yet. The folder (`audio/PartnerSounds`, `SoundNames`) is unit-tested; the playback (`SceneAudio.partnerSound`) and the Options rows are compiled by CI only and have not run on a phone.

## Building

Expand Down
1 change: 1 addition & 0 deletions wifecraft/android/app/src/main/AndroidManifest.xml
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@

<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/Theme.Wifecraft"
Expand Down
59 changes: 58 additions & 1 deletion wifecraft/android/app/src/main/assets/sounds.json
Original file line number Diff line number Diff line change
Expand Up @@ -10,21 +10,78 @@
"dusk": 1417236,
"night": 1417266
},
"places": {
"embassy": {
"ambience": 569,
"ambienceDay": [
539127
],
"ambienceNight": [
539080
],
"area": 9171,
"music": [
53205,
53206,
53208,
441767,
1417244,
1417249
],
"silenceMs": [
180000,
300000
],
"zoneMusic": 1929
}
},
"title": {
"kit": 262929,
"music": [
6075186
]
},
"ui": {
"click": [
"begin": [
567419
],
"check_off": [
567407
],
"check_on": [
567407
],
"click": [
567481
],
"close": [
567464
],
"create": [
567437
],
"ending": [
569143
],
"gossip": [
567504
],
"ok": [
567407
],
"open": [
567490
],
"page": [
567457,
567472,
567502
],
"select": [
567508
],
"tab": [
567422
]
},
"voices": {}
Expand Down
Loading
Loading