Display Issues
Sakura renders games at their native resolution by default and lets you adjust scaling and sharpening on top of that. If something looks off, start here.
Game Looks Soft or Blurry
Section titled “Game Looks Soft or Blurry”Cause: Most NScripter/ONScripter games run at a low native resolution designed for old PC monitors, so on a modern high-density screen the art can look soft when scaled up.
Solutions:
- Open Settings > ONScripter Engine (or per-game Game Settings, if Use Global Settings is off) and raise Render Scale to 2x or 3x. This supersamples the game at a higher internal resolution before scaling it to your screen. This takes effect at the next launch, not live.
- Try the Upscale Filter options — Smooth (linear, the default), xBRZ (an edge-preserving upscaler that suits pixel art), or Sharp. This one applies live to a running game, both from Settings and from the in-game overlay’s Settings window (“Upscaling”).
- Add some Sharpen (CAS) — contrast-adaptive sharpening, 0–100%, default 0 (off). This also applies live, via the overlay’s “Sharpen” slider or the global/per-game setting. It’s meant to crisp up soft, low-resolution art without a full re-render.
Resetting Display Settings Back to Default
Section titled “Resetting Display Settings Back to Default”If you’ve been experimenting with Render Scale, Upscale Filter, or Sharpen and want to get back to a known-good state:
- Render Scale → 1x (native, no supersampling)
- Upscale Filter → Smooth
- Sharpen (CAS) → 0% (off)
Set these in Settings > ONScripter Engine for the global defaults, or in a game’s Game Settings if it has Use Global Settings turned off (its per-game override needs to be reset there instead — turning “Use Global Settings” back on will make it follow the global values again).
Letterboxing / Black Bars Around the Game
Section titled “Letterboxing / Black Bars Around the Game”Cause: NScripter/ONScripter games are built for a fixed design resolution and aspect ratio. When that doesn’t match your device’s screen, Sakura letterboxes the game (fits it to the largest size that preserves its original aspect ratio) rather than stretching or cropping the art.
This is expected behavior, not a bug — stretching would distort the original artwork, and Sakura prioritizes showing the game as it was designed to look.
Everything Looks Tinted a Strange Color
Section titled “Everything Looks Tinted a Strange Color”Cause: This is very likely not the game rendering — it’s the Icon-Colored Game Pages setting, which tints a game’s own library/detail page (and its bubble particles) using colors sampled from its icon. It doesn’t touch the game’s actual rendering.
Solution: Go to Settings > General and turn off Icon-Colored Game Pages if you’d rather every game’s page use a neutral look.
Still Looks Wrong?
Section titled “Still Looks Wrong?”If a game’s actual in-game rendering looks broken (not just soft or tinted) — for example, corrupted sprites or backgrounds — that’s most likely an issue with the archive itself rather than a display setting; see Import Problems to check whether it extracted cleanly, or reach out via Support.