Maze 2.5D

on 7 Nov 2026
3
26
6
4
6652
game.m
function g = game()
g.init   = @initState;
g.update = @updateState;
g.render = @renderFrame;
end

function state = initState(ax)
state = struct();
state.v = .5;        % Move speed
state.time = 0;      % Elapsed time
state.theta = -pi/2; % Facing direction
% Map: 0=empty, 1=wall, 2=player, 3=target
state.map = [...
    1 1 1 1 1 1 1 1 1 1 1 1 1 1 1;
    1 0 0 0 0 0 1 0 1 0 1 0 0 0 1;
    1 1 1 1 1 0 1 0 0 0 1 1 1 0 1;
    1 0 0 0 1 2 1 0 1 0 1 0 0 0 1;
    1 0 1 1 1 0 0 0 1 0 0 0 1 1 1;
    1 0 0 0 0 0 1 1 1 0 1 1 1 0 1;
    1 0 1 0 1 1 1 0 1 0 0 0 1 0 1;
    1 0 1 0 0 0 0 0 1 1 1 0 1 0 1;
    1 0 1 1 1 1 1 1 1 0 1 0 0 0 1;
    1 0 1 0 0 0 0 0 0 0 1 0 1 0 1;
    1 0 1 1 1 1 1 0 1 0 1 0 1 0 1;
    1 0 1 0 1 0 1 0 1 0 0 0 1 0 1;
    1 0 1 0 1 0 1 0 1 1 1 1 1 0 1;
    1 0 0 0 0 0 0 0 1 3 0 0 0 0 1;
    1 1 1 1 1 1 1 1 1 1 1 1 1 1 1];
sz = length(state.map);
% Extract wall / player / target positions
[state.blkR, state.blkC] = find(state.map == 1);
[state.humR, state.humC] = find(state.map == 2);
[state.tgtR, state.tgtC] = find(state.map == 3);

state.lNum = 100; % Number of rays
state.pNum = 100; % Points per wall edge

% Sample points on each wall's 4 edges
lsL = linspace(-.5, .5, state.pNum).';
sqL = [lsL, lsL.*0 - .5; lsL, lsL.*0 + .5; lsL.*0 - .5, lsL; lsL.*0 + .5, lsL];
sqB = [state.blkR, state.blkC].'; 
sqB = repmat(sqB(:).', [size(sqL,1), 1]);
sqB = reshape([sqB(:, 1:2:end), sqB(:, 2:2:end)], [], 2);
sqL = repmat(sqL, size(state.blkR, 1), 1) + sqB;

state.c2x = @(c, sz) (c - .5)./sz.*400;
state.r2y = @(r, sz) (sz + 1 - r - .5)./sz.*400 + 100;
state.blkXY = [state.c2x(state.blkC, sz), state.r2y(state.blkR, sz)];
state.blkPixXY = [state.c2x(sqL(:,2), sz), state.r2y(sqL(:,1), sz)];
state.humX = state.c2x(state.humC, sz); state.humY = state.r2y(state.humR, sz);
state.tgtX = state.c2x(state.tgtC, sz); state.tgtY = state.r2y(state.tgtR, sz);
state.sp = [cos([-pi/3, pi/3, pi] + state.theta).*5 + state.humX; 
    sin([-pi/3, pi/3, pi] + state.theta).*5 + state.humY];
state.dis = .5./sz.*400;


[XX, YY] = meshgrid(linspace(0, 1, sz + 1));
CC = flipud(ind2rgb(state.map + 1, [0;1;0;0]*[1,1,1]));
CC(end + 1, end + 1, :) = 0;
fill(ax, [0,800,800,0], [0,0,600,600], [0,0,0])

% Left panel: 2D top-down map as textured surf
state.maze2d = surf(ax, XX.*400, YY.*400 + 100, XX.*0, CC, 'EdgeColor','none');
% Player triangle in 2D map
state.humHdl = fill(ax, state.sp(1, :), state.sp(2, :), [1,1,1], 'EdgeColor','none');

state.v2X = [];
state.v2Y = [];
state.v3X = [];
state.v3Y = [];
state.v3Z = [];
state.v2Hdl = plot(ax, -100, -100, 'Color',[79,148,204]./255);
% Right panel: pseudo-3D view objects
state.v3Hdl = surf(ax, [],[],[], 'EdgeColor','none');
state.t3X = [nan, nan, nan];
state.t3Y = [nan, nan, nan];
state.t3Z = [420, 420, 420];
state.t3Hdl = fill3(ax, state.t3X, state.t3Y, state.t3Z, [79,148,204]./255,'EdgeColor',[0,64,115]./255, 'LineWidth',2);
plot(ax, state.tgtX, state.tgtY, 'Marker','o', 'MarkerFaceColor',[79,148,204]./255, 'MarkerEdgeColor',[0,64,115]./255, 'LineWidth',2, 'MarkerSize',12)
colormap(ax, gray)
% Game information text handles
text(ax, 20, 50, 'Press and hold Space to adjust the forward direction.','Color','w', 'FontSize',21, 'FontWeight','bold')
text(ax, 20, 550, 'Maze 2.5D','Color','w', 'FontSize',30, 'FontWeight','bold')
state.winHdl = text(ax, 780, 550, ' ','Color','w', 'FontSize',30, 'FontWeight','bold', 'HorizontalAlignment','right');
end

function state = updateState(state, dt, pressed)

if norm([state.humX, state.humY] - [state.tgtX, state.tgtY]) < 1.8*state.dis
    state.winHdl.String = ['You win! Time: ', sprintf('%.2f', state.time), 's.'];
else
    state.time = state.time + dt;
if pressed % Hold Space: rotate in place
    state.theta = state.theta - pi/35;
else % Otherwise: try move forward
    tX = state.humX + cos(state.theta).*state.v;
    tY = state.humY + sin(state.theta).*state.v;
    tV = abs(state.blkXY - [tX, tY]);
    tB = (tV(:, 1) <= (state.dis + 5)) & (tV(:, 2)  <= (state.dis + 5));
    if any(tB)
    else
        state.humX = tX;
        state.humY = tY;
    end
end

% Raycasting
T0 = linspace(pi/3,-pi/3, state.lNum);
TT = T0 + state.theta;
V = state.blkPixXY - [state.humX, state.humY];
D = V*[cos(TT); sin(TT)];
D(D < 0) = inf;
N = vecnorm(V.').';
d = abs(D - repmat(N, [1, size(D,2)]));
D(d > .005) = inf;
M = min(abs(D));
% Check if target is visible in the fan
Vtgt = [state.tgtX, state.tgtY] - [state.humX, state.humY];
Dtgt = Vtgt*[cos(TT); sin(TT)];
Dtgt(Dtgt < 0) = inf; Ntgt = norm(Vtgt);
dtgt = abs(Dtgt - Ntgt);
Dtgt(dtgt > .005) = inf;
Ptgt = find(Dtgt < M);

% Wall column height: inverse distance + fisheye correction
L = 4000./abs(M)./abs(cos(T0)).*.9; L(L > 400) = 400;
% 2D ray line data
state.v2X = [repmat(state.humX, [1, state.lNum]); 
    repmat(state.humX, [1, state.lNum]) + cos(TT).*M;
    nan([1, state.lNum])];
state.v2Y = [repmat(state.humY, [1, state.lNum]); 
    repmat(state.humY, [1, state.lNum]) + sin(TT).*M;
    nan([1, state.lNum])];
% 3D wall mesh: x from tan projection, y/z from height
[state.v3X, state.v3Y] = meshgrid(- tan(T0)./tan(pi/3).*200 + 600, linspace(-.5, .5, 3));
state.v3Y = state.v3Y.*L + 300;
state.v3Z = repmat(L, [3, 1]);
% Player triangle in 2D map
state.sp = [cos([-pi/3, pi/3, pi] + state.theta).*5 + state.humX; 
    sin([-pi/3, pi/3, pi] + state.theta).*5 + state.humY];
% Render target in 3D view if visible
if ~isempty(Ptgt)
    idx = round((Ptgt(1) + Ptgt(end))/2);
    tt = linspace(0, 2*pi, 50);
    tr = 50 - Dtgt(idx)/2;
    tr(tr < 1) = 1;
    state.t3X = cos(tt).*tr + state.v3X(1, idx);
    state.t3Y = sin(tt).*tr + 300;
    state.t3Z = state.t3X.*0 + 420;
else
    state.t3X = [nan, nan, nan];
    state.t3Y = [nan, nan, nan];
    state.t3Z = [420, 420, 420];
end
end
end

function renderFrame(~, state)
state.v2Hdl.XData = state.v2X(:);
state.v2Hdl.YData = state.v2Y(:);
state.v3Hdl.XData = state.v3X;
state.v3Hdl.YData = state.v3Y;
state.v3Hdl.ZData = state.v3Z;
state.humHdl.XData = state.sp(1, :);
state.humHdl.YData = state.sp(2, :);
state.t3Hdl.XData = state.t3X;
state.t3Hdl.YData = state.t3Y;
state.t3Hdl.ZData = state.t3Z;
end
Play Game
Preview

Play Game opens this in MATLAB Drive. Click Run this app there to play.