Repository navigation
================================================================================
IWBasic — easy start (Windows, no install)
You do NOT need to install anything. No MSYS2. No developer tools.
What's new in this zip (2026-11-17, v4.11-beta19)
Native iwbc.exe + runtime rebuilt on Windows (win-dev).
3D samples: compile and link; skinnedXmesh loads media\tiny.x (static pose).
Landscape: the height bitmap (media\map.bmp) becomes a 3D mesh. coverage.bmp
colors the ground. The tile .tga files are not drawn yet.
Line continuation with trailing _; D3DCOLORVALUE / D3DMATERIAL; mesh helpers.
INSTR(string, find, start) now stores the match index. A start past the
match stores 0. The two-argument form is unchanged.
Also includes beta18 #ptr.field / STRING[0,pos] codegen and earlier sample fixes.
Try the included sample (1 minute)
-
Right-click the zip → Extract All…
Choose: Desktop\iwbasic (or any folder you like) -
Open the folder in File Explorer.
-
Double-click: COMPILE_SAMPLE.cmd
-
A black window should show:
Hello from IWBasic!
If Windows says "protected your PC":
Click More info → Run anyway
Run the demo programs (optional)
Open the run folder:
christmas_tree.exe — graphics demo
EB-BALLS.exe — bouncing balls (needs ball.bmp in same folder)
addressbook.exe — needs addressbook.mdb + sqlite3.dll in same folder
invaders.cmd — TEXT console game (do NOT double-click invaders.exe;
use invaders.cmd so the window stays open)
dict_core / math_core are text programs:
Double-click RUN_DICT_CORE.cmd / RUN_MATH_CORE.cmd
(or open Command Prompt in run\ and run the .exe)
invaders: double-click invaders.cmd (not invaders.exe)
3D (compile from samples\3D, needs media\tiny.x for skinnedXmesh):
Use COMPILE_ONE_IN_SAMPLES.cmd after copying the .iwb into samples,
or compile from samples\3D\ with the path that keeps media\ beside the .exe.
Compile YOUR program
-
Copy your file myprogram.iwb into the samples folder
(inside the iwbasic folder you extracted) -
Double-click: COMPILE_ONE_IN_SAMPLES.cmd
-
Look in the samples folder for myprogram.exe
Double-click it to run.
Problems?
"Windows protected your PC" on every program
→ More info → Run anyway (beta is not code-signed yet)
COMPILE_SAMPLE says a .dll is missing
→ Use the latest zip from GitHub Releases (DLLs belong in bin).
Do not copy random DLLs from elsewhere on your PC.
addressbook flashes and closes
→ Make sure run\sqlite3.dll is next to addressbook.exe (included in
current beta). Win11 usually has no Access database driver.
addressbook "New" freezes / MDB Viewer says unrecognized
→ addressbook.mdb is an IWBasic SQLite file that uses a .mdb name
(not Microsoft Access). Do not open it in Access/MDB Viewer.
Use the latest beta so New no longer hangs on Jet/ACE locks.
invaders blank / closes immediately
→ Double-click invaders.cmd (not invaders.exe)
Use a normal Command Prompt window (not Windows Terminal) if the
game still flashes blank.
Dialogs look pure white
→ Fixed in current beta (classic gray dialog face).
EB-BALLS not fullscreen / exits early with many balls
→ Fixed in current beta (fullscreen CREATESCREEN + ESC arm).
If it still exits with many balls, say how many and after how long.
No labels on addressbook / other dialogs
→ Fixed (static controls were wrongly created as bitmap statics).
smashout link errors (CreateSprite, ELLIPSE, …)
→ Fixed in current beta runtime.
3D window is black / no model
→ skinnedXmesh needs media\tiny.x next to the .exe (GETSTARTPATH).
Landscape needs media\map.bmp (24-bit). The ground is colored from
coverage.bmp. The tile .tga files are not drawn yet.
Send back: VERSION.txt from this folder + what you clicked + what happened
================================================================================