Skip to content

Latest commit

 

History

History
30 lines (21 loc) · 1.28 KB

restrictions.md

File metadata and controls

30 lines (21 loc) · 1.28 KB

Scripting restrictions

Flax tries to implement all the engine features and scripting APIs across all supported platforms. However, some platforms have permanent restrictions. This page helps with understanding and dealing with possible cross-platform limitations.

Not supported features

  • Debugger.Break()

Not supported APIs

  • System.Collections.Immutable.dll
  • System.Design.dll
  • System.Drawing.Design.dll
  • System.Reflection.Metadata.dll
  • System.Web.Extensions.Design.dll

Ahead-of-time compile

Ahead-of-time (AOT) compile is a technique used to precompile all the managed code during game building process instead of using just-in-time (JIT) compilation on the target device. That's because some platforms do not allow runtime code generation. In most cases this has no effect on game scripting but in a few specific cases, AOT platforms require additional consideration.

Because code generation is disabled in AOT mode (scripting backend throws an exception) the following features are not supported:

  • Methods from System.Reflection.Emit namespace are unsupported.
  • Generic virtual methods have restrictions.
  • When using generic types you need to declare generic attributes types to precompile them.

Platforms that use AOT:

  • Xbox One
  • Xbox Scarlett
  • UWP
  • PlayStation 4