ericoporto

Small guide on how to upgrade your existing game project to AGS 4.

Warnings

There are a few things that cannot be upgraded at the current time, so we need to warn you about it.

1. AGSJoy plugin: Attempts to build your game with this plugin active will not compile with AGS 4 because its Joystick struct will conflict with the AGS own Joystick struct. The solution is to either disable the newest script API level (by lowering it to v3.6.1, but that will also disable anything else), or adjust the code to work with the new Joystick API. The API is relatively simple, so upgrading should not be a huge problem. The plugin is no longer needed after that.

2. Speech Center and Translations: Speech Center with translations will stop working with this AGS 4 update. It won't crash, but it won't see translated strings. This is because Translation storage had changed in the Editor. The plugin will have to be updated to work with AGS 4.

ericoporto

import os
import argparse
import chardet

def is_text_file(filename, chunk_size=1024):
    """Check if the file is likely a text file by reading a small chunk."""
    try:
        with open(filename, 'rb') as f:
            chunk = f.read(chunk_size)
            # Use chardet to detect encoding and ensure it's text-like

ericoporto

#include <string>
#include "regex.h"


/*
 * Return a new string with all occurrences of 'from' replaced with 'to'
 */
std::string replace_all(const std::string &str, const char *from, const char *to)
{
    std::string result(str);

ericoporto

.\test\runner browser.test_sdl2_mixer_music_mp3
Test suites:
['test_browser']
Running test_browser: (1 tests)
(checking sanity from test runner)
shared:INFO: (Emscripten: Running sanity checks)
[Browser harness server on process 19864]
common:INFO: Launching browser: ['C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe']

Running the browser tests. Make sure the browser allows popups from localhost.

ericoporto

.\test\runner browser.test_sdl2_*
Test suites:
['test_browser']
Running test_browser: (48 tests)
(checking sanity from test runner)
shared:INFO: (Emscripten: Running sanity checks)
[Browser harness server on process 17704]
common:INFO: Launching browser: ['C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe']

Running the browser tests. Make sure the browser allows popups from localhost.

ericoporto

.\test\runner browser.test_sdl2_*
Test suites:
['test_browser']
Running test_browser: (48 tests)
(checking sanity from test runner)
shared:INFO: (Emscripten: Running sanity checks)
[Browser harness server on process 6876]
common:INFO: Launching browser: ['C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe']

Running the browser tests. Make sure the browser allows popups from localhost.

ericoporto

[82/107] Compiling C object tests/checkasm.exe.p/checkasm_checkasm.c.obj
FAILED: tests/checkasm.exe.p/checkasm_checkasm.c.obj
"cc" "-Itests/checkasm.exe.p" "-Itests" "-I../tests" "-I." "-I.." "-Iinclude/dav1d" "-I../include/dav1d" "-Iinclude" "-I../include" "-fdiagnostics-color=always" "-DNDEBUG" "-D_FILE_OFFSET_BITS=64" "-Wall" "-Winvalid-pch" "-Wextra" "-std=c99" "-O3" "-fvisibility=hidden" "-Wundef" "-Werror=vla" "-Wno-maybe-uninitialized" "-Wno-missing-field-initializers" "-Wno-unused-parameter" "-Wstrict-prototypes" "-Werror=missing-prototypes" "-fomit-frame-pointer" "-ffast-math" -MD -MQ tests/checkasm.exe.p/checkasm_checkasm.c.obj -MF "tests/checkasm.exe.p/checkasm_checkasm.c.obj.d" -o tests/checkasm.exe.p/checkasm_checkasm.c.obj "-c" ../tests/checkasm/checkasm.c
../tests/checkasm/checkasm.c: In function ΓÇÿsignal_handlerΓÇÖ:
../tests/checkasm/checkasm.c:504:29: error: variable ΓÇÿdefault_saΓÇÖ has initializer but incomplete type
  504 |         static const struct sigaction default_sa = { .sa_handler 

ericoporto

Describe the problem

The Dialog Scripts are great for writing dialog lines. But sometimes one wants to handle the logic of which dialog to run from elsewhere, like a Room Script. For a character that only exists in a room, or for a particular scene, it's useful to hold all dialogs in the same dialog script, so one doesn't have to open many different dialog scripts.

---

Suggested change

If possible to either add a parameter in dialog start or create a new dialog.Run(int x).

ericoporto

cd Android && ./and-build.sh build_debug
building debug library and runtime...
/tmp/cirrus-ci-build/Android /tmp/cirrus-ci-build/Android
/tmp/cirrus-ci-build/Android/agsplayer /tmp/cirrus-ci-build/Android /tmp/cirrus-ci-build/Android
Downloading https://services.gradle.org/distributions/gradle-8.3-bin.zip
............10%............20%.............30%............40%.............50%............60%.............70%............80%.............90%............100%

Welcome to Gradle 8.3!

Here are the highlights of this release:

ericoporto

The following part of jjsat commit here https://github.com/jjsat/ags/commit/22221b6d3ebffdd7c7e32e5ccb95a590e5a8307a#diff-4db3d150dec6fcd9180c42130e5d06d6f11649403d1a1d46700564785284e0dbR1456-R1481

We see that load.sp.offs was used to load the value of the stack pointer (SP) with an offset, moving the stack pointer up or down.

But then, after the commit, it changed from

case SCMD_LOADSPOFFS:
  inst->registers[SREG_MAR] = inst->registers[SREG_SP] - arg1;