Skip to main content

URL Parameters

RemixWarp supports URL parameters that let you load projects and adjust runtime and compiler behavior. These are useful for embedding, automation, and sharing reproducible setups.

Basic Usage​

URL Parameter Syntax​

Add parameters using standard query string format:

https://remixwarp.pages.dev/${projectId}`

Multiple Parameters​

Combine multiple parameters with &:

https://remixwarp.pages.dev/${projectId}`

Project Loading​

Load by ID​

Load a Scratch project by its ID:

https://remixwarp.pages.dev/${projectId}`

Load from URL​

Load a project from a direct URL:

https://remixwarp.pages.dev/${projectId}`

Auto-start (embed only)​

Automatically start the project in embeds:

https://remixwarp.pages.dev/${projectId}`?autoplay

Username​

Set the username used by cloud variables and blocks:

https://remixwarp.pages.dev/${projectId}`?username=alice

Performance​

Turbo Mode​

Enable high-speed execution:

https://remixwarp.pages.dev/${projectId}`

Frame Rate​

Set custom frame rate:

https://remixwarp.pages.dev/${projectId}`     # 60 FPS
https://remixwarp.pages.dev/${projectId}`    # 120 FPS
https://remixwarp.pages.dev/${projectId}`     # 30 FPS (default)

High Quality Pen​

Enable anti-aliased pen rendering:

https://remixwarp.pages.dev/${projectId}`

Interpolation​

Enable frame interpolation for smoother motion:

https://remixwarp.pages.dev/${projectId}`

Remove Misc Limits​

Disable certain runtime limits:

https://remixwarp.pages.dev/${projectId}`

Display​

Custom Stage Size​

Set custom stage dimensions:

https://remixwarp.pages.dev/${projectId}`
https://remixwarp.pages.dev/${projectId}`

Fullscreen Background (player-only)​

Control fullscreen background color:

https://remixwarp.pages.dev/${projectId}`

Offscreen Fencing​

Disable offscreen fencing:

https://remixwarp.pages.dev/${projectId}`

Clone Limit​

Set maximum clones:

https://remixwarp.pages.dev/${projectId}`

Extensions​

Load Extensions​

Load custom extensions by URL (unsandboxed recommended):

https://remixwarp.pages.dev/${projectId}`
https://remixwarp.pages.dev/${projectId}`

Addons (embed only)​

Enable specific addons in embeds:

https://remixwarp.pages.dev/${projectId}`/embed?addons=pause,gamepad

Embedding​

Autoplay and Addons​

Embed-specific options:

https://remixwarp.pages.dev/${projectId}`/embed?autoplay
https://remixwarp.pages.dev/${projectId}`/embed?addons=pause,gamepad

Development​

Disable Compiler​

Turn off the compiler (for debugging):

https://remixwarp.pages.dev/${projectId}`

Project URL​

Load project data from a direct URL:

https://remixwarp.pages.dev/${projectId}`

Cloud Host (embed/player)​

Override cloud server:

https://remixwarp.pages.dev/${projectId}`

Reference​

Complete Parameter Reference​

Performance​

ParameterValuesDescription
turbobooleanEnable turbo mode
fpsnumberSet frame rate
hqpenbooleanHigh quality pen
interpolatebooleanEnable interpolation
limitlessbooleanDisable misc limits
stuckbooleanEnable warp timer (player-only)

Display​

ParameterValuesDescription
sizeWIDTHxHEIGHTCustom stage size
fullscreen-backgroundCSS colorFullscreen background color
offscreenbooleanDisable offscreen fencing

Project​

ParameterValuesDescription
usernamestringUsername
project_urlURLLoad from URL

Extensions​

ParameterValuesDescription
extensionURLLoad extension by URL

Development​

ParameterValuesDescription
nocompilebooleanDisable compiler
cloud_hostwss://...Custom cloud host

URL Parameter Examples​

Gaming Setup​

Optimized for games:

https://remixwarp.pages.dev/${projectId}`?turbo&fps=60&interpolate

Educational Embedding​

Clean embed for education:

https://remixwarp.pages.dev/${projectId}`/embed?autoplay&size=800x600

Development Testing​

Development environment:

https://remixwarp.pages.dev/${projectId}`&fps=120&hqpen

High Performance​

Maximum performance:

https://remixwarp.pages.dev/${projectId}`&fps=120&hqpen

Accessible Mode​

Use OS/browser accessibility features. Theme is controlled in the UI, not via URL.

URL Encoding​

Special Characters​

Encode special characters in URLs:

Space: %20
#: %23
&: %26
=: %3D

Example with Encoding​

https://remixwarp.pages.dev/${projectId}`&hqpen

JavaScript URL Manipulation​

Reading Parameters​

const urlParams = new URLSearchParams(window.location.search);
const turboMode = urlParams.has('turbo');
const fps = urlParams.get('fps') || '30';

Setting Parameters​

const url = new URL(window.location);
url.searchParams.set('fps', '60');
url.searchParams.set('turbo', '');
window.history.pushState({}, '', url);

Building URLs Programmatically​

function buildRemixWarpURL(projectId, options = {}) {
  const url = new URL(`https://remixwarp.pages.dev/${projectId}`);
  
  Object.entries(options).forEach(([key, value]) => {
    if (value === true) {
      url.searchParams.set(key, '');
    } else if (value !== false && value !== null) {
      url.searchParams.set(key, value);
    }
  });
  
  return url.toString();
}

// Usage
const gameURL = buildRemixWarpURL('123456789', {
  turbo: true,
  fps: 60,
  interpolate: true
});

Best Practices​

URL Length​

  • Keep URLs reasonable length (under 2000 characters)
  • Use essential parameters only
  • Consider using short parameter names

User Experience​

  • Provide sensible defaults
  • Use autoplay sparingly
  • Test URLs thoroughly

Performance​

  • Combine compatible performance parameters
  • Test performance impact of parameter combinations
  • Monitor for conflicts between parameters

URL parameters provide powerful customization capabilities for RemixWarp. Use them to create tailored experiences for different users and use cases!