I'm a doctor, not a mechanic

UE3:Commandlet (UT3)

From Unreal Wiki, The Unreal Engine Documentation Site
Jump to: navigation, search
UT3 Object >> Commandlet
Package: 
Core
Direct subclass:
HelpCommandlet
This class in other games:
RTNP, U1, UT, UE2Runtime, UT2003, U2, U2XMP, UT2004, UDK

Copyright 1998-2007 Epic Games, Inc. All Rights Reserved.

UnrealScript Commandlet (command-line applet) class.

Commandlets are executed from the ucc.exe command line utility, using the following syntax:

   yourgame.exe package_name.commandlet_class_name [parm=value]...

for example:

   yourgame.exe Core.HelloWorldCommandlet
   yourgame.exe Editor.MakeCommandlet

As a convenience, if a user tries to run a commandlet and the exact name he types isn't found, then ucc.exe appends the text "commandlet" onto the name and tries again. Therefore, the following shortcuts perform identically to the above:

   yourgame.exe Core.HelloWorld
   yourgame.exe Editor.Make

Commandlets are executed in a "raw" UnrealScript environment, in which the game isn't loaded, the client code isn't loaded, no levels are loaded, and no actors exist.

Properties

HelpDescription

Type: string

Modifiers: localized

Description of the commandlet's purpose

HelpParamDescriptions

Type: array<string>

Modifiers: localized

The description of the parameter

HelpParamNames

Type: array<string>

Modifiers: localized

The name of the parameter the commandlet takes

HelpUsage

Type: string

Modifiers: localized

Usage template to show for "ucc help"

HelpWebLink

Type: string

Modifiers: localized

Hyperlink for more info

IsClient

Type: bool

Whether to load objects required in server, client, and editor context. If IsEditor is set to false, then a UGameEngine (or whatever the value of Engine.Engine.GameEngine is) will be created for the commandlet instead of a UEditorEngine (or Engine.Engine.EditorEngine), unless the commandlet overrides the CreateCustomEngine method.

Default value: True

IsEditor

Type: bool

Whether to load objects required in server, client, and editor context. If IsEditor is set to false, then a UGameEngine (or whatever the value of Engine.Engine.GameEngine is) will be created for the commandlet instead of a UEditorEngine (or Engine.Engine.EditorEngine), unless the commandlet overrides the CreateCustomEngine method.

Default value: True

IsServer

Type: bool

Whether to load objects required in server, client, and editor context. If IsEditor is set to false, then a UGameEngine (or whatever the value of Engine.Engine.GameEngine is) will be created for the commandlet instead of a UEditorEngine (or Engine.Engine.EditorEngine), unless the commandlet overrides the CreateCustomEngine method.

Default value: True

LogToConsole

Type: bool

Whether to redirect standard log to the console

ShowErrorCount

Type: bool

Whether to show standard error and warning count on exit

Default value: True

Native functions

Main

native event int Main (string Params)

Entry point for your commandlet

Parameters:

  • Params - the string containing the parameters for the commandlet